Skip to main content
GET
/
api
/
v1
/
subscribers
/
{id}
/
cards
curl -X GET "https://olive-gateway-a6ba.onrender.com/api/v1/subscribers/sub_abc123/cards" \
  -H "Authorization: Bearer olive_live_xxx"
{
  "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
}

Request

Authorization
string
required
Bearer olive_live_xxx or Bearer eyJ... (JWT)

Path Parameters

id
string
required
Subscriber UUID (e.g., sub_abc123)

Response

cards
array
Array of card objects linked to subscriber
count
integer
Total number of cards

Examples

curl -X GET "https://olive-gateway-a6ba.onrender.com/api/v1/subscribers/sub_abc123/cards" \
  -H "Authorization: Bearer olive_live_xxx"
{
  "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
}

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

StatusDescription
ACTIVECard can be used for transactions
BLOCKEDCard temporarily blocked
LOSTReported lost, permanently disabled
EXPIREDCard past expiry date

Errors

StatusCodeDescription
401UNAUTHORIZEDInvalid or missing API key
404NOT_FOUNDSubscriber not found
500INTERNAL_ERRORServer error