Skip to main content

​
1. Create a business account

API keys are available to business accounts only. If you haven’t set one up:
  1. Register or log in at check.et
  2. Complete the business setup wizard
  3. Go to Dashboard → API Keys and click Create key
  4. Copy the key - it is shown once and never again
Store your API key securely. It grants full verification access to your business account.

​
2. Make your first request

Replace YOUR_API_KEY with the key you just copied. 
curl -X POST https://api.check.et/api/v1/verify \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "bank": "cbe",
    "transaction_number": "FT25161234567"
  }'

​
3. Read the response

{
  "success": true,
  "exists": true,
  "duplicate": false,
  "message": null,
  "data": {
    "bank": "cbe",
    "bank_name": "Commercial Bank of Ethiopia",
    "verification_id": "FT25161234567",
    "transaction_number": "FT25161234567",
    "source_url": null,
    "verification_method": "official",
    "receipt": {
      "status": "completed",
      "amount": 1350.00,
      "currency": "ETB",
      "transaction_date": "2025-06-10T14:30:00+03:00",
      "payer_name": "Hayat Ahmed",
      "payer_account": "100012345678",
      "receiver_name": "Abebe Bekele",
      "receiver_account": "100087654321",
      "description": "Payment for invoice #1042"
    }
  }
}
FieldMeaning
successtrue = payment exists and is confirmed
existstrue = transaction found in bank records
duplicatetrue = this transaction was already verified in your branch
data.receiptParsed transaction details from the bank

​
Next steps