Get Card

GET/cards/{serial}Open in the API playground →

Request

Authorizationstringheaderrequired

Bearer olive_live_xxx or Bearer eyJ... (JWT)

Path Parameters

serialstringpathrequired

Card serial number (e.g., OLIV0001)

---

Response

cardobject

Card Object

serialstring

Card serial number

mac_addressstring

Card MAC address

typestring

Card type: PARENT or CHILD

statusstring

Card status: ACTIVE, BLOCKED, UNASSIGNED

subscriber_idstring

Linked subscriber UUID (if assigned)

subscriber_namestring

Linked subscriber name

daily_limitinteger

Daily limit in cents (child cards only)

parent_serialstring

Parent card serial (child cards only)

---

Examples

Request

cURL

curl -X GET "https://demo.api.vultlocal.com/api/v1/cards/OLIV0001" \
  -H "Authorization: Bearer olive_live_xxx"

Response

200 Parent Card

{
  "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"
  }
}

200 Child Card

{
  "card": {
    "serial": "OLIV0002",
    "mac_address": "AA:BB:CC:DD:EE:02",
    "type": "CHILD",
    "status": "ACTIVE",
    "subscriber_id": "sub_abc123",
    "parent_serial": "OLIV0001",
    "daily_limit": 5000000,
    "child_name": "Jane Doe",
    "linked_at": "2025-01-16T14:00:00Z"
  }
}

404 Not Found

{
  "error": "Card not found",
  "code": "CARD_NOT_FOUND"
}

---

Errors

Status	Code	Description
401	UNAUTHORIZED	Invalid or missing API key
404	CARD_NOT_FOUND	Card serial not found
500	INTERNAL_ERROR	Server error