# Overview

> Verify Ethiopian receipt URLs from one API endpoint hosted in Ethiopia.

`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](/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](/dashboard/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](/docs/providers) 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.

```bash
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 .
```

```json
{
  "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](/docs/verify).