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

# Authentication

> Every request is authenticated with an API key in the X-API-Key header.

All requests (except `/api/status`) require your API key in the **`X-API-Key`** header.

```bash theme={null}
curl https://api.apinn.io/api/sports \
  -H "X-API-Key: pnk_your_key"
```

## Getting & managing your key

Your key is issued at signup and visible in your [account area](https://www.apinn.io/account). You can **regenerate** it at any time — the old one is then invalidated immediately.

<Warning>
  Never share your key or expose it on the browser side. Call the API from your server.
</Warning>

## Error responses

| Code  | Meaning                                               |
| ----- | ----------------------------------------------------- |
| `401` | Key missing, invalid or revoked.                      |
| `429` | Hourly quota exceeded — see the `Retry-After` header. |
| `422` | Required parameter missing (e.g. `event_id`).         |

```json 401 theme={null}
{ "detail": "Not authenticated" }
```

See [Rate limits](/en/rate-limits) for details on the `Retry-After` header and counting.