Transaction Status API

Check Transaction Status

Query the status of any transaction using its unique reference code.

GET https://speedpesa.com/api/v1/status?reference=YOUR_REFERENCE

Query Parameters

Parameter	Type	Required	Description
`reference`	string	Yes	Transaction reference code from response

cURL Example

curl -X GET "https://speedpesa.com/api/v1/status?reference=A1B2C3D4E5" \ -H "x-api-key: YOUR_API_KEY"

JSON Response

Pending Success Refunds Failed

{ "type": "info", "message": "Transaction is being processed", "data": { "reference": "BB92446CBC", "type": "payment", "direction": "credit", "amount": "500.00", "fee": "0.00", "total": "500.00", "currency": "TZS", "status": "PENDING", "status_message": "Transaction is being processed", "resultcode": null, "completed": null, "channel": "N/A", "channelprovider": "AIRTEL-MONEY", "accountnumber": "255683759997", "accountname": "N/A", "narration": "Receive Payment via USSD", "description": "", "created": "2026-03-24 11:40:35", "updated": "2026-03-24 11:40:35" } }

{ "type": "success", "message": "Transaction completed successfully", "data": { "reference": "2FDC871A4B", "type": "payout", "direction": "debit", "amount": "2700.00", "fee": "145.00", "total": "2845.00", "currency": "TZS", "status": "SUCCESS", "status_message": "Transaction completed successfully", "resultcode": null, "completed": "2026-03-19 14:48:48", "channel": "N/A", "channelprovider": "MPESA TANZANIA", "accountnumber": "255791043501", "accountname": "JOSEPH IYOGHO", "narration": "Mobile Money Payout", "description": "Payout via MPESA TANZANIA to JOSEPH IYOGHO (255791043501)", "created": "2026-03-19 14:48:48", "updated": "2026-03-19 14:48:48" } }

{ "type": "info", "message": "Status retrieved", "data": { "reference": "6ED01123C2", "type": "payout", "direction": "debit", "amount": "11500.00", "fee": "900.00", "total": "12400.00", "currency": "TZS", "status": "REFUNDED", "status_message": "Unknown status", "resultcode": null, "completed": "2026-03-17 07:57:14", "channel": "MOBILE MONEY", "channelprovider": "HALOPESA TANZANIA", "accountnumber": "255617919056", "accountname": "JOSEPH MELKIZEDEKI IYOGHO", "narration": "Mobile Money Payout", "description": "Payout via HALOPESA TANZANIA to JOSEPH MELKIZEDEKI IYOGHO (255617919056)", "created": "2026-03-17 07:55:29", "updated": "2026-03-17 07:57:16" } }

{ "type": "error", "message": "Transaction failed", "data": { "reference": "9675790FA7", "type": "payment", "direction": "credit", "amount": "500.00", "fee": "0.00", "total": "500.00", "currency": "TZS", "status": "FAILED", "status_message": "Transaction failed", "resultcode": null, "completed": "2026-03-29 08:31:18", "channel": "AIRTEL-MONEY", "channelprovider": "AIRTEL-MONEY", "accountnumber": "255687819056", "accountname": "JOSEPH IYOGHO", "narration": "Payment received", "description": "", "created": "2026-03-29 08:26:17", "updated": "2026-03-29 08:31:21" } }

Transaction Status API Documentation

Authentication

Required Headers

Check Transaction Status

Query Parameters

cURL Example

JSON Response

Ready to Transform Your Payments?