# links.et

> Verify Ethiopian payment receipts at the source. POST a receipt URL, reference or screenshot and links.et fetches it from the bank over an Ethiopia-egress link and returns the parsed receipt as JSON. 17 banks and wallets, one response envelope.

Base URL `https://links.et`. Authenticate with an `x-api-key` header;
keys are minted from the dashboard. Every doc below is also served as
markdown at the same path with `.md` appended.

## Integrating

- [Agent file](https://links.et/agents.md): drop-in instructions for a coding agent: endpoints, auth, retry policy and the pitfalls, in one file.
- [Full docs as one file](https://links.et/llms-full.txt): every page below, concatenated.

## Docs

- [Overview](https://links.et/docs.md): Verify Ethiopian receipt URLs from one API endpoint hosted in Ethiopia.
- [Authentication](https://links.et/docs/authentication.md): API keys are minted from the dashboard and passed via the x-api-key header.
- [POST /api/verify](https://links.et/docs/verify.md): Fetch + parse a single receipt URL across all supported providers.
- [POST /api/verify-image](https://links.et/docs/verify-image.md): Lift the reference token off a receipt screenshot, then cross-check it against the upstream verifier.
- [Integration flows](https://links.et/docs/integration-flows.md): Three ways to consume /api/verify (short wait, polling, and SSE) plus idempotency replay. Pick whichever matches how your app handles latency.
- [Coding agents](https://links.et/docs/agents.md): A drop-in agent file, llms.txt, and a markdown twin of every docs page.
- [Providers overview](https://links.et/docs/providers.md): Every supported receipt host, the source tag each one stamps on its receipt, and the shape it returns.
- [Telebirr](https://links.et/docs/providers/telebirr.md): Detail page: URL format, reference shape, return type, and quirks for telebirr receipts.
- [CBE](https://links.et/docs/providers/cbe.md): Detail page: four URL shapes (two short-link variants and two direct endpoints), two response schemas (PDF and JSON), and how the resolver routes between them.
- [Zemen Bank](https://links.et/docs/providers/zemen.md): Detail page: URL token structure (24-char prefix + reference composite), PDF parsing quirks, and full return type.
- [Bank of Abyssinia](https://links.et/docs/providers/boa.md): Detail page: public SPA URL, underlying API endpoint, token format, and return shape.
- [Awash Bank](https://links.et/docs/providers/awash.md): Detail page: public receipt URL, page structure, captured fields, and return shape.
- [Health / Status API](https://links.et/docs/health.md): Two open endpoints for monitors and dashboards: a single-purpose health probe and a structured per-component status snapshot.
- [Errors](https://links.et/docs/errors.md): Error envelope and codes.
- [Rate limits](https://links.et/docs/rate-limits.md): Two different ceilings, the request rate and the plan's verification cap, plus the screenshot read allowance.