> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ethioreview.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Reference

> Interactive OpenAPI reference for the EthioReview API.

Browse the interactive reference below for request shapes, response fields, and authentication requirements.

## Authentication

| Integration        | Credential               | Header                  |
| ------------------ | ------------------------ | ----------------------- |
| Website widget     | Publishable key (`pk_*`) | `X-Widget-Key`          |
| Server integration | Secret key (`sk_*`)      | `Authorization: Bearer` |
| Dashboard session  | User session             | Cookie / session token  |

See [Authentication](/authentication) for key types, rotation, and allowed origins.

## Common endpoint groups

| Area                 | Purpose                                              |
| -------------------- | ---------------------------------------------------- |
| Widgets              | Read reviews and ratings for public embeds           |
| ApiClients           | Create and manage API credentials (dashboard)        |
| OrganizationTelegram | Link groups, collection links, notification settings |
| Partner API          | Server-to-server read and write for integrators      |

<Note>
  Only use credentials issued to your organization. Never share secret keys in support tickets, logs, or client-side code.
</Note>

Browse the full interactive reference in the sidebar (OpenAPI).