Overview
Agent-TS
Subscribers
Cards
Wallet
Agents
Compliance
Admin
Processors
Suspicious Transactions
Copy
curl -X GET "https://olive-gateway-a6ba.onrender.com/api/v1/cards/OLIV0001" \
-H "Authorization: Bearer olive_live_xxx"
Copy
{
"card": {
"serial": "OLIV0001",
"mac_address": "AA:BB:CC:DD:EE:01",
"type": "PARENT",
"status": "ACTIVE",
"subscriber_id": "sub_abc123",
"subscriber_name": "John Doe",
"linked_at": "2025-01-15T10:30:00Z",
"created_at": "2025-01-01T00:00:00Z"
}
}
Cards
Get Card
Retrieve card details by serial number
GET
/
api
/
v1
/
cards
/
{serial}
Copy
curl -X GET "https://olive-gateway-a6ba.onrender.com/api/v1/cards/OLIV0001" \
-H "Authorization: Bearer olive_live_xxx"
Copy
{
"card": {
"serial": "OLIV0001",
"mac_address": "AA:BB:CC:DD:EE:01",
"type": "PARENT",
"status": "ACTIVE",
"subscriber_id": "sub_abc123",
"subscriber_name": "John Doe",
"linked_at": "2025-01-15T10:30:00Z",
"created_at": "2025-01-01T00:00:00Z"
}
}
Request
Bearer olive_live_xxx or Bearer eyJ... (JWT)Path Parameters
Card serial number (e.g.,
OLIV0001)Response
Show Card Object
Show Card Object
Card serial number
Card MAC address
Card type:
PARENT or CHILDCard status:
ACTIVE, BLOCKED, UNASSIGNEDLinked subscriber UUID (if assigned)
Linked subscriber name
Daily limit in cents (child cards only)
Parent card serial (child cards only)
Examples
Copy
curl -X GET "https://olive-gateway-a6ba.onrender.com/api/v1/cards/OLIV0001" \
-H "Authorization: Bearer olive_live_xxx"
Copy
{
"card": {
"serial": "OLIV0001",
"mac_address": "AA:BB:CC:DD:EE:01",
"type": "PARENT",
"status": "ACTIVE",
"subscriber_id": "sub_abc123",
"subscriber_name": "John Doe",
"linked_at": "2025-01-15T10:30:00Z",
"created_at": "2025-01-01T00:00:00Z"
}
}
Errors
| Status | Code | Description |
|---|---|---|
| 401 | UNAUTHORIZED | Invalid or missing API key |
| 404 | CARD_NOT_FOUND | Card serial not found |
| 500 | INTERNAL_ERROR | Server error |
⌘I