List cards
curl --request GET \
--url https://api.global.direct.reap.global/2026-11-16/cards \
--header 'x-api-key: <api-key>'const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.global.direct.reap.global/2026-11-16/cards', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.global.direct.reap.global/2026-11-16/cards"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"items": [
{
"id": "3db05d6f-97a9-4c06-a578-087b14b4f859",
"type": "virtual",
"status": "active",
"title": "Travel card",
"last4": "4242",
"expiresAt": "2028-08-31",
"isRevolving": false,
"planType": "topUp",
"category": "Travel",
"cardholder": {
"userId": "user_01JZ2Q1J4Y8P7M6N5K3H2G1F0E",
"name": "Ada Lovelace",
"email": "ada@example.com"
},
"spendCap": {
"amount": "5000.00",
"currency": "USD"
},
"spentAmount": {
"amount": "0.00",
"currency": "USD"
},
"spendControl": {
"limits": {
"transaction": {
"amount": "1000.00",
"currency": "USD"
},
"monthly": {
"amount": "5000.00",
"currency": "USD"
}
},
"spent": {
"monthly": {
"amount": "0.00",
"currency": "USD"
}
},
"atm": {
"dailyWithdrawal": {
"amount": "500.00",
"currency": "USD"
},
"dailyFrequency": 3
}
},
"restriction": {
"time": {
"start": "09:00",
"end": "18:00"
},
"category": {
"allow": true,
"values": [
"flights"
]
}
},
"createdAt": "2026-07-13T08:00:00.000Z",
"updatedAt": "2026-07-13T08:00:00.000Z"
}
],
"meta": {
"totalItems": 1,
"itemCount": 1,
"itemsPerPage": 20,
"totalPages": 1,
"currentPage": 1
}
}Cards
List cards
Required API-key scope: cards:read.
Returns the cards on your Business Account, with each card’s status, cardholder, budget, spending limits and how much it has spent. Use it to show a card list in your own tools, find a card by cardholder, nickname or last four digits, or check which cards are close to their limits. To get a single card, use Retrieve a card. See Cards.
GET
/
2026-11-16
/
cards
List cards
curl --request GET \
--url https://api.global.direct.reap.global/2026-11-16/cards \
--header 'x-api-key: <api-key>'const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.global.direct.reap.global/2026-11-16/cards', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.global.direct.reap.global/2026-11-16/cards"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"items": [
{
"id": "3db05d6f-97a9-4c06-a578-087b14b4f859",
"type": "virtual",
"status": "active",
"title": "Travel card",
"last4": "4242",
"expiresAt": "2028-08-31",
"isRevolving": false,
"planType": "topUp",
"category": "Travel",
"cardholder": {
"userId": "user_01JZ2Q1J4Y8P7M6N5K3H2G1F0E",
"name": "Ada Lovelace",
"email": "ada@example.com"
},
"spendCap": {
"amount": "5000.00",
"currency": "USD"
},
"spentAmount": {
"amount": "0.00",
"currency": "USD"
},
"spendControl": {
"limits": {
"transaction": {
"amount": "1000.00",
"currency": "USD"
},
"monthly": {
"amount": "5000.00",
"currency": "USD"
}
},
"spent": {
"monthly": {
"amount": "0.00",
"currency": "USD"
}
},
"atm": {
"dailyWithdrawal": {
"amount": "500.00",
"currency": "USD"
},
"dailyFrequency": 3
}
},
"restriction": {
"time": {
"start": "09:00",
"end": "18:00"
},
"category": {
"allow": true,
"values": [
"flights"
]
}
},
"createdAt": "2026-07-13T08:00:00.000Z",
"updatedAt": "2026-07-13T08:00:00.000Z"
}
],
"meta": {
"totalItems": 1,
"itemCount": 1,
"itemsPerPage": 20,
"totalPages": 1,
"currentPage": 1
}
}Filter and sort cards
Pass one or more public statuses separated by commas, for examplestatus=active,frozen.
Status filters match the status returned on each card, including lifecycle flags and expiry rules.
Filter creation or last update time with createdAt[gte], createdAt[lt], updatedAt[gte] and updatedAt[lt].
gte includes its instant; lt excludes it. Either bound can be omitted.
A date such as 2026-10-01 means midnight UTC. Timestamps must include Z or a timezone offset.
When encoding an offset in a URL, encode + as %2B.
For active or frozen cards created during October:
GET /2026-07-13/cards?status=active,frozen&createdAt[gte]=2026-10-01&createdAt[lt]=2026-11-01&sort=createdAt:desc
GET /2026-07-13/cards?updatedAt[gte]=2026-11-04T08:00:00Z&sort=updatedAt:asc
400.
When both bounds are supplied, gte must be strictly before lt.
Sort by id, createdAt or updatedAt, optionally followed by :asc or :desc.
The default direction is ascending. Timestamp sorts use card ID in the same direction to break ties.
Omitting sort preserves the existing ordering.
The ordering is deterministic for unchanged data; page/limit pagination does not provide a snapshot when cards change between requests.