Live Demo
Test the API by entering a Telebirr transaction ID below.
API Documentation
v1.0
GET
/verify/{transactionId}
Replace {transactionId} with the 10-character transaction ID from the receipt URL.
Example Request
GET http://localhost:3000/verify/DBN54S90BX
Example Response
{
"transactionId": "DBN54S90BX",
"verified": true,
"payerName": "Shamil Nasir Seid",
"payerTelebirrNo": "2519****5143",
"creditedPartyName": "Ethio telecom",
"creditedPartyAccountNo": "111222",
"transactionStatus": "Completed",
"invoiceNo": "DBN54S90BX",
"paymentDate": "23-02-2026 19:50:47",
"settledAmount": "1275.00 Birr"
}Response Fields
- transactionId The unique 10-character transaction ID
- verified Boolean validation indicating if status is completed
- payerName Full name of the individual making the payment
- payerTelebirrNo Masked phone number of the payer
- creditedPartyName Name of the receiving merchant or party
- creditedPartyAccountNo Account or shortcode of the credited party
- transactionStatus Current status (e.g., "Completed")
- invoiceNo Associated invoice or reference number
- paymentDate Timestamp of the transaction
- settledAmount Total amount settled, formatted with currency