Subscriber Cards
GET
/subscribers/{id}/cardsOpen in the API playground →
Request
Authorizationstringheaderrequired
Bearer olive_live_xxx or Bearer eyJ... (JWT)
Path Parameters
idstringpathrequired
Subscriber UUID (e.g., sub_abc123)
Response
cardsarray
Array of card objects linked to subscriber
countinteger
Total number of cards
Examples
Request
cURL
curl -X GET "https://demo.api.vultlocal.com/api/v1/subscribers/sub_abc123/cards" \
-H "Authorization: Bearer olive_live_xxx"
Response
200 OK
{
"cards": [
{
"serial": "OLIV0001",
"type": "PARENT",
"status": "ACTIVE",
"mac_address": "AA:BB:CC:DD:EE:01",
"linked_at": "2025-01-15T10:30:00Z"
},
{
"serial": "OLIV0002",
"type": "CHILD",
"status": "ACTIVE",
"mac_address": "AA:BB:CC:DD:EE:02",
"daily_limit": 50000,
"parent_serial": "OLIV0001",
"linked_at": "2025-01-16T14:00:00Z"
}
],
"count": 2
}
200 No Cards
{
"cards": [],
"count": 0
}
Card Types
Parent Card
- Primary card linked to subscriber
- Full access to wallet balance
- Can manage child cards
Child Card
- Linked to parent card
- Daily spending limit
- For dependents/employees
Card Status
| Status | Description |
|---|---|
ACTIVE | Card can be used for transactions |
BLOCKED | Card temporarily blocked |
LOST | Reported lost, permanently disabled |
EXPIRED | Card past expiry date |
Errors
| Status | Code | Description |
|---|---|---|
| 401 | UNAUTHORIZED | Invalid or missing API key |
| 404 | NOT_FOUND | Subscriber not found |
| 500 | INTERNAL_ERROR | Server error |