Skip to main content
GET
/
subscribers
/
{id}
/
cards
curl -X GET "https://demo.api.vultlocal.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
}

Documentation Index

Fetch the complete documentation index at: https://docs.vultlocal.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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://demo.api.vultlocal.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

Link Card

Link a new card to subscriber

Create Child Card

Create a child card

Authorizations

​
Authorization
string
header
required

API Key for third-party integrations (WhatsApp, Smart PAY, VULT). Format: 'Bearer olive_live_xxxxxxxxxxxxx'

Path Parameters

​
id
string
required

Subscriber ID

Response

List of cards

The response is of type object.