curl --request GET \
--url https://api.next.orenda.finance/v2/customers/{customerId}/cards/spend-limits \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.next.orenda.finance/v2/customers/{customerId}/cards/spend-limits"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.next.orenda.finance/v2/customers/{customerId}/cards/spend-limits', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.next.orenda.finance/v2/customers/{customerId}/cards/spend-limits",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.next.orenda.finance/v2/customers/{customerId}/cards/spend-limits"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.next.orenda.finance/v2/customers/{customerId}/cards/spend-limits")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.next.orenda.finance/v2/customers/{customerId}/cards/spend-limits")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"message": "<string>",
"data": {
"customerId": "<string>",
"programId": "<string>",
"asOf": "<string>",
"truncated": true,
"cards": [
{
"cardId": "<string>",
"accountId": "<string>",
"status": "<string>",
"provider": "<string>",
"currency": "<string>",
"tier": "<string>",
"accountType": "<string>",
"appliedTier": "<string>",
"appliedAccountType": "<string>",
"card": {
"enabled": true,
"mode": "<string>",
"singleTransaction": {
"atm": "<string>",
"pos": "<string>"
},
"buckets": [
{
"bucket": "<string>",
"daily": {
"amount": {
"limit": "<string>",
"used": "<string>",
"remaining": "<string>",
"enforced": true
},
"count": {
"limit": 123,
"used": 123,
"remaining": 123,
"enforced": true
}
},
"weekly": {
"amount": {
"limit": "<string>",
"used": "<string>",
"remaining": "<string>",
"enforced": true
},
"count": {
"limit": 123,
"used": 123,
"remaining": 123,
"enforced": true
}
},
"monthly": {
"amount": {
"limit": "<string>",
"used": "<string>",
"remaining": "<string>",
"enforced": true
},
"count": {
"limit": 123,
"used": 123,
"remaining": 123,
"enforced": true
}
},
"annual": {
"amount": {
"limit": "<string>",
"used": "<string>",
"remaining": "<string>",
"enforced": true
},
"count": {
"limit": 123,
"used": 123,
"remaining": 123,
"enforced": true
}
},
"usageError": "<string>"
}
]
},
"customer": {
"enabled": true,
"mode": "<string>",
"singleTransaction": {
"atm": "<string>",
"pos": "<string>"
},
"buckets": [
{
"bucket": "<string>",
"daily": {
"amount": {
"limit": "<string>",
"used": "<string>",
"remaining": "<string>",
"enforced": true
},
"count": {
"limit": 123,
"used": 123,
"remaining": 123,
"enforced": true
}
},
"weekly": {
"amount": {
"limit": "<string>",
"used": "<string>",
"remaining": "<string>",
"enforced": true
},
"count": {
"limit": 123,
"used": 123,
"remaining": 123,
"enforced": true
}
},
"monthly": {
"amount": {
"limit": "<string>",
"used": "<string>",
"remaining": "<string>",
"enforced": true
},
"count": {
"limit": 123,
"used": 123,
"remaining": 123,
"enforced": true
}
},
"annual": {
"amount": {
"limit": "<string>",
"used": "<string>",
"remaining": "<string>",
"enforced": true
},
"count": {
"limit": 123,
"used": 123,
"remaining": 123,
"enforced": true
}
},
"usageError": "<string>"
}
]
},
"available": {
"atm": {
"amount": "<string>",
"maxTransaction": "<string>",
"transactions": 123,
"limitedBy": {
"scope": "<string>",
"window": "<string>",
"measure": "<string>"
}
},
"pos": {
"amount": "<string>",
"maxTransaction": "<string>",
"transactions": 123,
"limitedBy": {
"scope": "<string>",
"window": "<string>",
"measure": "<string>"
}
}
},
"error": "<string>",
"errorDetail": "<string>"
}
]
}
}Get spend limits and usage (v2)
What the customer’s cards may spend, and what they already have.
Amounts. Each card carries its currency, and every amount on it (limit, used, remaining, the single-transaction caps, and available) is a decimal string in major units of that currency, for example "250.50". limit: null means no limit is configured, not a limit of zero. The count measures are transaction counts and stay integers.
A card whose currency cannot be determined is still listed, with currency: null, no amounts and error: "CURRENCY_UNAVAILABLE", so one card never hides the others.
Read mode before rendering: under COMBINED there is one TOTAL bucket, under PER_CHANNEL there are ATM and POS. Two gates decide a transaction and both are returned per card: card and customer. Use available for “what can this card spend now?” and limitedBy for which limit is binding. Returns every card on the customer’s accounts, newest first, capped at 25 (truncated: true when there are more); pass cardId to ask about one card.
curl --request GET \
--url https://api.next.orenda.finance/v2/customers/{customerId}/cards/spend-limits \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.next.orenda.finance/v2/customers/{customerId}/cards/spend-limits"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.next.orenda.finance/v2/customers/{customerId}/cards/spend-limits', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.next.orenda.finance/v2/customers/{customerId}/cards/spend-limits",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.next.orenda.finance/v2/customers/{customerId}/cards/spend-limits"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.next.orenda.finance/v2/customers/{customerId}/cards/spend-limits")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.next.orenda.finance/v2/customers/{customerId}/cards/spend-limits")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"message": "<string>",
"data": {
"customerId": "<string>",
"programId": "<string>",
"asOf": "<string>",
"truncated": true,
"cards": [
{
"cardId": "<string>",
"accountId": "<string>",
"status": "<string>",
"provider": "<string>",
"currency": "<string>",
"tier": "<string>",
"accountType": "<string>",
"appliedTier": "<string>",
"appliedAccountType": "<string>",
"card": {
"enabled": true,
"mode": "<string>",
"singleTransaction": {
"atm": "<string>",
"pos": "<string>"
},
"buckets": [
{
"bucket": "<string>",
"daily": {
"amount": {
"limit": "<string>",
"used": "<string>",
"remaining": "<string>",
"enforced": true
},
"count": {
"limit": 123,
"used": 123,
"remaining": 123,
"enforced": true
}
},
"weekly": {
"amount": {
"limit": "<string>",
"used": "<string>",
"remaining": "<string>",
"enforced": true
},
"count": {
"limit": 123,
"used": 123,
"remaining": 123,
"enforced": true
}
},
"monthly": {
"amount": {
"limit": "<string>",
"used": "<string>",
"remaining": "<string>",
"enforced": true
},
"count": {
"limit": 123,
"used": 123,
"remaining": 123,
"enforced": true
}
},
"annual": {
"amount": {
"limit": "<string>",
"used": "<string>",
"remaining": "<string>",
"enforced": true
},
"count": {
"limit": 123,
"used": 123,
"remaining": 123,
"enforced": true
}
},
"usageError": "<string>"
}
]
},
"customer": {
"enabled": true,
"mode": "<string>",
"singleTransaction": {
"atm": "<string>",
"pos": "<string>"
},
"buckets": [
{
"bucket": "<string>",
"daily": {
"amount": {
"limit": "<string>",
"used": "<string>",
"remaining": "<string>",
"enforced": true
},
"count": {
"limit": 123,
"used": 123,
"remaining": 123,
"enforced": true
}
},
"weekly": {
"amount": {
"limit": "<string>",
"used": "<string>",
"remaining": "<string>",
"enforced": true
},
"count": {
"limit": 123,
"used": 123,
"remaining": 123,
"enforced": true
}
},
"monthly": {
"amount": {
"limit": "<string>",
"used": "<string>",
"remaining": "<string>",
"enforced": true
},
"count": {
"limit": 123,
"used": 123,
"remaining": 123,
"enforced": true
}
},
"annual": {
"amount": {
"limit": "<string>",
"used": "<string>",
"remaining": "<string>",
"enforced": true
},
"count": {
"limit": 123,
"used": 123,
"remaining": 123,
"enforced": true
}
},
"usageError": "<string>"
}
]
},
"available": {
"atm": {
"amount": "<string>",
"maxTransaction": "<string>",
"transactions": 123,
"limitedBy": {
"scope": "<string>",
"window": "<string>",
"measure": "<string>"
}
},
"pos": {
"amount": "<string>",
"maxTransaction": "<string>",
"transactions": 123,
"limitedBy": {
"scope": "<string>",
"window": "<string>",
"measure": "<string>"
}
}
},
"error": "<string>",
"errorDetail": "<string>"
}
]
}
}