curl -X POST "https://demo.api.vultlocal.com/api/v1/wallet/transactions/sub_abc123" \
-H "Authorization: Bearer olive_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"pin": "1234",
"limit": 20,
"offset": 0
}'
{
"success": true,
"transactions": [
{
"id": "txn_abc123",
"type": "transfer_p2p",
"status": "completed",
"amount": 5000000,
"amount_formatted": "50,000.00 SLE",
"fee": 75000,
"direction": "debit",
"counterparty": {
"name": "Jane Smith",
"card_serial": "OLIV0002"
},
"balance_after": 7500000,
"memo": "Payment for services",
"created_at": "2025-01-15T10:30:00Z"
},
{
"id": "txn_def456",
"type": "agent_cashin",
"status": "completed",
"amount": 10000000,
"amount_formatted": "100,000.00 SLE",
"fee": 0,
"direction": "credit",
"counterparty": {
"name": "Agent ABC",
"type": "agent"
},
"balance_after": 12500000,
"created_at": "2025-01-14T15:00:00Z"
}
],
"total_count": 45,
"limit": 20,
"offset": 0
}
Wallet
Transaction History
Get transaction history for a subscriber
POST
/
wallet
/
transactions
/
{subscriber_id}
curl -X POST "https://demo.api.vultlocal.com/api/v1/wallet/transactions/sub_abc123" \
-H "Authorization: Bearer olive_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"pin": "1234",
"limit": 20,
"offset": 0
}'
{
"success": true,
"transactions": [
{
"id": "txn_abc123",
"type": "transfer_p2p",
"status": "completed",
"amount": 5000000,
"amount_formatted": "50,000.00 SLE",
"fee": 75000,
"direction": "debit",
"counterparty": {
"name": "Jane Smith",
"card_serial": "OLIV0002"
},
"balance_after": 7500000,
"memo": "Payment for services",
"created_at": "2025-01-15T10:30:00Z"
},
{
"id": "txn_def456",
"type": "agent_cashin",
"status": "completed",
"amount": 10000000,
"amount_formatted": "100,000.00 SLE",
"fee": 0,
"direction": "credit",
"counterparty": {
"name": "Agent ABC",
"type": "agent"
},
"balance_after": 12500000,
"created_at": "2025-01-14T15:00:00Z"
}
],
"total_count": 45,
"limit": 20,
"offset": 0
}
Returns paginated transaction history. Requires PIN verification for security.
Request
string
required
Bearer olive_live_xxx or Bearer eyJ... (JWT)Path Parameters
string
required
Subscriber UUID
Body Parameters
string
required
Subscriber’s 4-digit PIN
integer
default:"20"
Results per page (max 100)
integer
default:"0"
Pagination offset
Response
array
Array of transaction objects
integer
Total transactions
integer
Current page size
integer
Current offset
Examples
curl -X POST "https://demo.api.vultlocal.com/api/v1/wallet/transactions/sub_abc123" \
-H "Authorization: Bearer olive_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"pin": "1234",
"limit": 20,
"offset": 0
}'
{
"success": true,
"transactions": [
{
"id": "txn_abc123",
"type": "transfer_p2p",
"status": "completed",
"amount": 5000000,
"amount_formatted": "50,000.00 SLE",
"fee": 75000,
"direction": "debit",
"counterparty": {
"name": "Jane Smith",
"card_serial": "OLIV0002"
},
"balance_after": 7500000,
"memo": "Payment for services",
"created_at": "2025-01-15T10:30:00Z"
},
{
"id": "txn_def456",
"type": "agent_cashin",
"status": "completed",
"amount": 10000000,
"amount_formatted": "100,000.00 SLE",
"fee": 0,
"direction": "credit",
"counterparty": {
"name": "Agent ABC",
"type": "agent"
},
"balance_after": 12500000,
"created_at": "2025-01-14T15:00:00Z"
}
],
"total_count": 45,
"limit": 20,
"offset": 0
}
Transaction Fields
| Field | Description |
|---|---|
type | Transaction type (see overview) |
status | completed, pending, failed, reversed |
direction | credit (incoming) or debit (outgoing) |
counterparty | Other party details |
balance_after | Balance after transaction |
Errors
| Status | Code | Description |
|---|---|---|
| 400 | INVALID_PIN_FORMAT | PIN must be 4 digits |
| 401 | INVALID_PIN | PIN verification failed |
| 401 | UNAUTHORIZED | Invalid API key |
| 404 | SUBSCRIBER_NOT_FOUND | Subscriber not found |
| 500 | INTERNAL_ERROR | Server error |
Authorizations
ApiKeyAuthBearerAuth
API Key for third-party integrations (WhatsApp, Smart PAY, VULT). Format: 'Bearer olive_live_xxxxxxxxxxxxx'
Path Parameters
Subscriber ID
Body
application/json
Transaction history request with PIN
Response
Transaction history
The response is of type object.
⌘I