Free Ethiopian Receipt Verification API

Free REST API for verifying Ethiopian bank receipts.

Read the API docs

API overview

cheki provides a free REST API for verifying Ethiopian bank receipts. No API key, no signup; requests are rate limited per IP. The API supports single verification, batch verification (up to 20 at once), bank listing, and health checking.

Quick start

POST to https://cheki.et/api/verify with a JSON body containing the bank code and the receipt link or reference in the bank's current format (BOA, and older CBE FT-only receipts, also need the account number). The response includes sender name, receiver name, amount, date, and the source URL from the bank.

Available endpoints

  • POST /api/verify: verify a single receipt
  • POST /api/verify/batch: verify up to 20 receipts, 5 at a time
  • GET /api/banks: list all supported banks
  • GET /api/health: check endpoint health and latency
  • GET /api/receipt: download the original receipt file

Frequently asked questions

Do I need an API key?

No. cheki's API requires no authentication. Just POST to /api/verify with the bank code, reference, and account number.

Is there a rate limit?

Yes, per IP: /api/verify 30 per minute, /api/verify/batch 5 per minute, /api/parse and /api/ocr 20 per minute each. Over the limit you get a 429 with a Retry-After header. For batch verification, use POST /api/verify/batch to verify up to 20 receipts at once.

Is there a TypeScript SDK?

Yes. cheki includes a TypeScript SDK that you can import and use in any Node.js or browser project. There's also a Python library and a CLI tool.

Read the API docs

Open cheki

Related guides