API DOCUMENTATION
Integrate Ethiopian payment verification across CBE, Telebirr, and Bank of Abyssinia, into your applications.
BASE URL
https://verify.bernos.et/apiAUTHENTICATION
Include your API key in the request header:
X-API-Key: bv_your_api_keyRATE LIMITS
ANONYMOUS5 requests/day
REGISTERED (FREE)10 requests/day
API WITH BALANCEUnlimited (5 ETB/req)
POST
/api/verify-cbeVerify a CBE transaction using the reference number and account number.
REQUEST
POST /api/verify-cbe
Content-Type: application/json
X-API-Key: your_api_key_here
{
"transactionRef": "FT26095HT668",
"accountNumber": "1000680017250"
}RESPONSE
{
"status": "success",
"data": {
"bank": "Commercial Bank of Ethiopia",
"document_type": "VAT Invoice/Customer Receipt",
"status": "Verified",
"transaction_reference": "FT26095HT668",
"payment_date": "4/5/2026, 7:58:00 PM",
"payer_name": "ABEBE KEBEDE BEKELE",
"payer_account": "1****1427",
"receiver_name": "Mr Dawit Tesfaye Mekonnen",
"receiver_account": "1****7259",
"transferred_amount": "60.00 ETB",
"commission": "0.50 ETB",
"total_debited": "60.61 ETB",
"pdf_available": true
}
}POST
/api/upload-cbeUpload an image containing a QR code with CBE transaction reference.
REQUEST
POST /api/upload-cbe
X-API-Key: your_api_key_here
Content-Type: multipart/form-data
image: <file>POST
/api/scan-cbeVerify a transaction reference extracted from a scanned QR code.
REQUEST
POST /api/scan-cbe
Content-Type: application/json
X-API-Key: your_api_key_here
{
"transactionRef": "FT26095HT668",
"accountNumber": "1000680017250"
}POST
/api/verify-telebirrVerify a Telebirr receipt using the 10-character receipt reference.
REQUEST
POST /api/verify-telebirr
Content-Type: application/json
X-API-Key: your_api_key_here
{
"reference": "CJ81K4M9PQ"
}RESPONSE
{
"status": "success",
"data": {
"bank": "Telebirr",
"document_type": "Telebirr Transaction Receipt",
"status": "Verified",
"transaction_reference": "CJ81K4M9PQ",
"payment_date": "11-06-2026 08:34:12",
"payer_name": "Sara Tesfaye Lemma",
"payer_account": "0911223344",
"receiver_name": "Dawit Bekele Asfaw",
"receiver_account": "0922334455",
"transferred_amount": "250.00 ETB",
"commission": "0.00 ETB",
"total_debited": "250.00 ETB",
"pdf_available": true
}
}POST
/api/verify-abyssiniaVerify a Bank of Abyssinia transfer receipt using the FT-prefixed reference.
REQUEST
POST /api/verify-abyssinia
Content-Type: application/json
X-API-Key: your_api_key_here
{
"reference": "FT26AB12CD34"
}RESPONSE
{
"status": "success",
"data": {
"bank": "Bank of Abyssinia",
"document_type": "Transfer Receipt",
"status": "Verified",
"transaction_reference": "FT26AB12CD34",
"payment_date": "29/05/26 14:21",
"payer_name": "Hanna Girma Wolde",
"payer_account": "1200000012345",
"receiver_name": "Yonas Alemu Tadesse",
"receiver_account": "1200000067890",
"transferred_amount": "1,500.00 ETB",
"total_debited": "1,500.00 ETB",
"pdf_available": true
}
}