Transaction Status API

Authentication

Every request requires your API key in the headers.

Required Headers

Content-Type application/json

Header Name x-api-key

Alternative Authorization: Bearer KEY

Check Transaction Status

Retrieve the real-time status of any transaction using its reference. Get instant updates on pending, completed, or failed payments.

POST https://speedpesa.com/api/v1/status

Request Body (JSON)

Field	Type	Required	Description
`reference`	string	Yes	Unique transaction reference ID

cURL Example

curl -X POST https://speedpesa.com/api/v1/status \ -H "Content-Type: application/json" \ -H "x-api-key: YOUR_API_KEY" \ -d '{ "reference": "D86A82954C" }'

JSON Response

Success Pending Failed Error

{ "type": "success", "message": "Transaction completed successfully", "data": { "reference": "D86A82954C", "type": "API Payout", "direction": "debit", "amount": "1000.00", "fee": "144.00", "total": "1144.00", "currency": "TZS", "status": "SUCCESS", "status_message": "Transaction completed successfully", "resultcode": 0, "completed": "2026-06-23 12:00:00", "channel": "MOBILE", "channelprovider": "Airtel Tanzania", "accountnumber": "0687819056", "accountname": "Joseph", "narration": "Payment to Joseph", "description": "API Payout", "created": "2026-06-23 11:55:00", "updated": "2026-06-23 12:00:00" } }

{ "type": "info", "message": "Transaction is being processed", "data": { "reference": "D86A82954C", "type": "API Payout", "direction": "debit", "amount": "1000.00", "fee": "144.00", "total": "1144.00", "currency": "TZS", "status": "PENDING", "status_message": "Transaction is being processed", "resultcode": null, "completed": null, "channel": "MOBILE", "channelprovider": "Airtel Tanzania", "accountnumber": "0687819056", "accountname": "Joseph", "narration": "Payment to Joseph", "description": "API Payout", "created": "2026-06-23 11:55:00", "updated": "2026-06-23 11:55:00" } }

{ "type": "error", "message": "Transaction failed", "data": { "reference": "D86A82954C", "type": "API Payout", "direction": "debit", "amount": "1000.00", "fee": "144.00", "total": "1144.00", "currency": "TZS", "status": "FAILED", "status_message": "Transaction failed", "resultcode": 1, "completed": "2026-06-23 12:05:00", "channel": "MOBILE", "channelprovider": "Airtel Tanzania", "accountnumber": "0687819056", "accountname": "Joseph", "narration": "Payment to Joseph", "description": "API Payout", "created": "2026-06-23 11:55:00", "updated": "2026-06-23 12:05:00" } }

{ "type": "error", "message": "Transaction reference not found" }