Overview

links.et fetches receipts from the official provider over an Ethiopia-egress link and returns the parsed receipt as JSON. Built for backends that can't reach the provider directly from their region.

How it works

1. Sign up at /signup and mint an API key from the dashboard.
2. POST the receipt URL to /api/verify.
3. We fetch the receipt from the official provider, parse it, and return JSON.

Prefer clicking over curl? The playground runs the same calls from your dashboard, with your API key and ready-made example requests for every endpoint.

Supported providers

17 banks and wallets, plus HuluBeje point-of-sale receipts. telebirr, CBE, CBE Birr, Bank of Abyssinia, Zemen, Awash, Dashen, M-PESA, COOPay, Kaafi, Amhara, Abay, Berhan, Oromia, Ahadu, Siinqee and ZamZam.

The providers page has the host for each one, the source tag it stamps on the receipt, and the shape it returns. Switch on source rather than on the host: several banks serve more than one host, and two of them share one.

Quick example

References shown here are placeholders; substitute one from a receipt you control.

curl -sX POST https://links.et/api/verify \
  -H "x-api-key: vk_live_..." \
  -H "content-type: application/json" \
  -d '{"url":"https://transactioninfo.ethiotelecom.et/receipt/ABCD1234EF"}' | jq .

{
  "ok": true,
  "providerKey": "telebirr",
  "resolvedUrl": "https://transactioninfo.ethiotelecom.et/receipt/ABCD1234EF",
  "httpStatus": 200,
  "fetchedAt": "2026-01-01T00:00:00.000Z",
  "receipt": {
    "source": "telebirr-html",
    "payerName": "<payer name>",
    "transactionStatus": "Completed",
    "receiptNo": "ABCD1234EF",
    "totalPaidAmount": "100 Birr",
    "paymentDate": "01-01-2026 00:00:00"
  },
  "rawHtmlLength": 25928,
  "error": null
}

CBE responses have a different shape; see POST /api/verify.