Legacy: transaction status
Token ds_live_ / ds_test_GET
/api/{kind}/{id}Returns a data or airtime transaction in the MSORG shape, whichever format you bought it with.
Language
curl -X GET "https://finaldatasub.com/api/data/88231" \
-H "Authorization: Token ds_live_YOUR_KEY" \
-H "Accept: application/json"Authentication
Send your secret API key in the header. Authorization: Bearer … and X-API-Key: … are also accepted.
| Header | Value | Required |
|---|---|---|
| Authorization | Token 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
Responses
201 Created — Successful / processing · 404 Not Found — Not found
{
"id": 88231,
"ident": "DS261005101522K7Q2ZP4M",
"network": 1,
"mobile_number": "08031234567",
"balance_before": "25000.00",
"balance_after": "24520.00",
"Status": "successful",
"api_response": "You have successfully purchased MTN SME 1GB - 30 Days for 08031234567.",
"create_date": "2026-10-05T10:15:22+01:00",
"Ported_number": true,
"plan": 212,
"plan_name": "MTN SME 1GB - 30 Days",
"plan_amount": "480.00"
}Errors
Errors specific to this endpoint, in addition to the authentication and validation errors common to every request.
| Code | HTTP | When |
|---|---|---|
| “Transaction not found.” | 404 | No transaction with this id on your account. |
Notes
- Failed transactions are returned with HTTP 400 and
Status: failed.