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

# Authentication

> Authenticate public Datashop API requests with an API key.

Every public API request requires a Datashop API key.

```http theme={null}
Authorization: Bearer YOUR_API_KEY
```

```bash theme={null}
curl https://app.datashop.africa/api/v2/get-services \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Common authentication errors

| Status | Code                        | Meaning                              |
| ------ | --------------------------- | ------------------------------------ |
| `401`  | `AUTH_MISSING`              | API key was not provided.            |
| `401`  | `API_KEY_INVALID`           | API key is invalid or inactive.      |
| `403`  | `API_KEY_IP_DENIED`         | Request IP is not allowed.           |
| `403`  | `API_KEY_ROUTE_NOT_ALLOWED` | API key cannot access this endpoint. |
| `429`  | `API_KEY_RATE_LIMIT`        | Rate limit exceeded.                 |