Verify by Receipt Text

curl --request POST \
  --url https://api.check.et/api/v1/verify \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "bank": "cbe",
  "transaction_number": "FT26144SG2ST",
  "account_number": "1000876543218"
}
'

{
  "success": true,
  "exists": true,
  "duplicate": false,
  "message": null,
  "data": {
    "bank": "cbe",
    "bank_name": "Commercial Bank of Ethiopia",
    "verification_id": "FT26144SG2ST",
    "transaction_number": "FT26144SG2ST",
    "source_url": null,
    "verification_method": "official",
    "receipt": {
      "status": "completed",
      "transaction_type": "transfer",
      "amount": 1350,
      "currency": "ETB",
      "transaction_date": "2025-06-10T14:30:00+03:00",
      "payer_name": "Hayat Ahmed",
      "payer_account": "1000126543218",
      "receiver_name": "Abebe Bekele",
      "receiver_account": "1000876543218",
      "description": "Payment"
    }
  }
}

{
  "message": "The transaction_number field is required."
}

{
  "message": "Unauthenticated."
}

{
  "message": "Monthly verification limit reached. Please upgrade your plan."
}

{
  "success": false,
  "exists": false,
  "duplicate": false,
  "message": "Transaction not found.",
  "data": {
    "bank": "cbe",
    "bank_name": "Commercial Bank of Ethiopia",
    "verification_id": null,
    "transaction_number": "FT26144SG2ST",
    "verification_method": "official",
    "receipt": {}
  }
}

{
  "message": "The given data was invalid.",
  "errors": {}
}

POST

verify

curl --request POST \
  --url https://api.check.et/api/v1/verify \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "bank": "cbe",
  "transaction_number": "FT26144SG2ST",
  "account_number": "1000876543218"
}
'

{
  "success": true,
  "exists": true,
  "duplicate": false,
  "message": null,
  "data": {
    "bank": "cbe",
    "bank_name": "Commercial Bank of Ethiopia",
    "verification_id": "FT26144SG2ST",
    "transaction_number": "FT26144SG2ST",
    "source_url": null,
    "verification_method": "official",
    "receipt": {
      "status": "completed",
      "transaction_type": "transfer",
      "amount": 1350,
      "currency": "ETB",
      "transaction_date": "2025-06-10T14:30:00+03:00",
      "payer_name": "Hayat Ahmed",
      "payer_account": "1000126543218",
      "receiver_name": "Abebe Bekele",
      "receiver_account": "1000876543218",
      "description": "Payment"
    }
  }
}

{
  "message": "The transaction_number field is required."
}

{
  "message": "Unauthenticated."
}

{
  "message": "Monthly verification limit reached. Please upgrade your plan."
}

{
  "success": false,
  "exists": false,
  "duplicate": false,
  "message": "Transaction not found.",
  "data": {
    "bank": "cbe",
    "bank_name": "Commercial Bank of Ethiopia",
    "verification_id": null,
    "transaction_number": "FT26144SG2ST",
    "verification_method": "official",
    "receipt": {}
  }
}

{
  "message": "The given data was invalid.",
  "errors": {}
}

Pass receipt_text in the request body. The text can be OCR output from a receipt image or manually copied from the app.

Use case

Customer photographs their receipt
Your app runs OCR (e.g. Google ML Kit, Tesseract)
You send the extracted text to Check.et
Check.et parses the bank and reference, then verifies

Tips

Add "bank": "cbe" as a hint if you know the bank - improves parsing accuracy
The text doesn’t need to be clean; Check.et handles noise from OCR
Max receipt_text length: 50,000 characters

Example

{
  "receipt_text": "Commercial Bank of Ethiopia\nFT Reference: FT26144SG2ST\nAmount: ETB 1,350.00\nDate: 10 Jun 2025\nPayer: Hayat Ahmed",
  "bank": "cbe",
  "account_number": "1000876543218"
}

Authorizations

Authorization

string

header

required

API key from your dashboard - starts with chk_. Requires a business account.

Body

bank

enum<string>

Bank code. Required unless using receipt_url, receipt_file, or receipt_text.

Available options:

cbe,

telebirr,

dashen,

awash,

boa,

zemen,

cbebirr,

mpesa,

sinqee,

amhara

Example:

"cbe"

transaction_number

string

Reference number from the receipt. Required unless using receipt_url, receipt_file, or receipt_text.

Example:

"FT26144SG2ST"

account_number

string

Your receiving account (required for CBE, BOA). For CBE Birr, pass the payer's phone number (251XXXXXXXXX).

Example:

"1000876543218"

bank_account_id

integer

ID of a saved bank account - use instead of account_number.

receipt_url

string

Share URL from the banking app. Auto-extracts bank and transaction number.

Example:

"https://apps.ethiotelecom.et/receipt/DEL889NG4S"

receipt_text

string

OCR'd text from a receipt image (max 50,000 chars). Required alongside image files.

Response

Verified - success: true means the payment is confirmed

success

boolean

true = transaction confirmed

Example:

true

exists

boolean

true = transaction found in bank records

Example:

true

duplicate

boolean

true = already verified in this branch

Example:

false

message

string | null

Example:

null

data

object

Show child attributes

existing_verification_id

integer

Only present when duplicate=true

Example:

9812

verified_at

string<date-time>

Only present when duplicate=true

Overview

Verifications

Banks

Bank Accounts

Verify by Receipt Text

Use case

Tips

Example

Authorizations

Body

Response

​Use case

​Tips

​Example

Authorizations

Body

Response

Use case

Tips

Example