List transactions
Bearer ds_live_ / ds_test_GET
/api/v1/merchant/transactionsReturns your transactions, newest first, in the same shape as purchase responses. Includes purchases made on the web and app as well as through the API.
Language
curl -X GET "https://finaldatasub.com/api/v1/merchant/transactions?status=successful&category=data&from=2026-10-01&to=2026-10-05" \
-H "Authorization: Bearer ds_live_YOUR_KEY" \
-H "Accept: application/json"Authentication
Send your secret API key in the header. Authorization: Token … and X-API-Key: … are also accepted.
| Header | Value | Required |
|---|---|---|
| Authorization | Bearer ds_live_YOUR_KEY | Yes |
| Accept | application/json | Recommended |
Authentication failures (401 UNAUTHORIZED, 403 IP_NOT_ALLOWED / ACCOUNT_SUSPENDED / API_ACCESS_NOT_APPROVED, 429 RATE_LIMITED) are listed in Authentication.
Parameters
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
| status | string | No | successful, failed, or any other value (e.g. pending) for transactions still in progress. |
| category | string | No | One category: data, airtime, electricity, cable, education, betting, internet, voice, bulk_sms, rechargepin, giftcard, esim. |
| from | date | No | Created on or after this date, YYYY-MM-DD. |
| to | date | No | Created on or before this date, YYYY-MM-DD. |
| per_page | integer | No | Results per page, 1–100 (default 50). |
| page | integer | No | Page number (default 1). |
Responses
200 OK — OK
{
"count": 1,
"data": [
{
"status": "successful",
"reference": "ORDER-10021",
"channel": "api",
"transaction_id": "DS261005101522K7Q2ZP4M",
"category": "data",
"message": "Transaction successful.",
"network": "MTN",
"biller": "MTN Data",
"biller_slug": "mtn-data",
"product_id": 212,
"product": "MTN SME 1GB - 30 Days",
"plan": "MTN SME 1GB - 30 Days",
"phone": "08031234567",
"customer_ref": "08031234567",
"quantity": 1,
"unit_amount": "480.00",
"amount": "480.00",
"face_amount": "500.00",
"fee": "0.00",
"discount": "20.00",
"total_deducted": "480.00",
"balance_before": "25000.00",
"balance_after": "24520.00",
"provider_reference": "PRV-88213409",
"purchased_at": "2026-10-05T10:15:22+01:00"
}
],
"meta": {
"current_page": 1,
"last_page": 1,
"per_page": 50
}
}Notes
countis the total number of matching transactions across all pages.