API Reference

Verify Ethiopian bank and mobile money payment receipts with a single REST endpoint.

Base URL

https://receipt-check.vercel.app

POST /api/verify

Submit a receipt reference for verification. Returns immediately with the result.

Request Body

Field	Type	Required	Description
bank	string	Yes	Bank/wallet identifier
reference	string	Yes	Receipt reference or transaction number
accountSuffix	string	Conditional	Required for CBE (8 digits) and BOA (5 digits)
phoneNumber	string	Conditional	Required for CBE Birr wallet lookups

Supported Banks

Bank ID	Name	Fields
cbe	Commercial Bank of Ethiopia	reference, accountSuffix (8)
telebirr	Telebirr	reference
boa	Bank of Abyssinia	reference, accountSuffix (5)
dashen	Dashen Bank	reference
awash	Awash Bank	reference
mpesa	M-Pesa	reference
cbebirr	CBE Birr	reference, phoneNumber
siinqee	Siinqee Bank	reference
kaafiebirr	Kaafi Ebirr	reference

Response

{
  "success": true,
  "verified": true,
  "message": "Transaction verified successfully.",
  "data": {
    "amount": 1500.00,
    "currency": "ETB",
    "payer": "Natnael Birhanu",
    "receiver": null,
    "reference": "FT1234567890",
    "paidAt": "2026-08-15T10:30:00.000Z",
    "bank": "cbe"
  },
  "requestId": "req_abc123..."
}

Examples

cURL - CBE

curl -X POST https://receipt-check.vercel.app/api/verify \
  -H "Content-Type: application/json" \
  -d '{
    "bank": "cbe",
    "reference": "FT1234567890",
    "accountSuffix": "12345678"
  }'

cURL - Telebirr

curl -X POST https://receipt-check.vercel.app/api/verify \
  -H "Content-Type: application/json" \
  -d '{
    "bank": "telebirr",
    "reference": "CJ12AB34CD"
  }'

Telegram Bot

You can also verify receipts directly in Telegram. Search for @ReceiptCheckBot on Telegram and send a reference number.

Error Codes

Status	Meaning
200	Success (check `verified` field)
400	Invalid request (missing bank/reference)
500	Internal server error