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"
}
}
Retrieve subscriber details by 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"
}
}
Bearer olive_live_xxx or Bearer eyJ... (JWT)sub_abc123)Show Subscriber Object
ACTIVE, BLOCKED, PENDINGcurl -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"
}
}
| Status | Code | Description |
|---|---|---|
| 401 | UNAUTHORIZED | Invalid or missing API key |
| 404 | NOT_FOUND | Subscriber ID does not exist |
| 500 | INTERNAL_ERROR | Server error |