Skip to main content
GET
/
api
/
v1
/
subscribers
/
{id}
curl -X GET "https://olive-gateway-a6ba.onrender.com/api/v1/subscribers/sub_abc123" \
  -H "Authorization: Bearer olive_live_xxx"
{
  "subscriber": {
    "id": "sub_abc123",
    "phone_number": "+23279123456",
    "first_name": "John",
    "last_name": "Doe",
    "email": "john@example.com",
    "date_of_birth": "1990-05-15",
    "address": "123 Main Street, Freetown",
    "kyc_level": 2,
    "status": "ACTIVE",
    "balance": "125,000.00 SLE",
    "id_number": "SL12345678",
    "id_type": "NATIONAL_ID",
    "vult_wallet_id": "vult_xyz789",
    "cards_count": 2,
    "max_child_cards": 4,
    "created_at": "2025-01-15T10:30:00Z",
    "updated_at": "2025-01-20T14:45:00Z"
  }
}

Request

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

Path Parameters

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

Response

subscriber
object

Examples

curl -X GET "https://olive-gateway-a6ba.onrender.com/api/v1/subscribers/sub_abc123" \
  -H "Authorization: Bearer olive_live_xxx"
{
  "subscriber": {
    "id": "sub_abc123",
    "phone_number": "+23279123456",
    "first_name": "John",
    "last_name": "Doe",
    "email": "john@example.com",
    "date_of_birth": "1990-05-15",
    "address": "123 Main Street, Freetown",
    "kyc_level": 2,
    "status": "ACTIVE",
    "balance": "125,000.00 SLE",
    "id_number": "SL12345678",
    "id_type": "NATIONAL_ID",
    "vult_wallet_id": "vult_xyz789",
    "cards_count": 2,
    "max_child_cards": 4,
    "created_at": "2025-01-15T10:30:00Z",
    "updated_at": "2025-01-20T14:45:00Z"
  }
}

Errors

StatusCodeDescription
401UNAUTHORIZEDInvalid or missing API key
404NOT_FOUNDSubscriber ID does not exist
500INTERNAL_ERRORServer error