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

# Authentication

> Authenticate Kanarie API requests with your API key.

Kanarie API uses Bearer API-key authentication for API requests:

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

The `x-kanarie-api-key: YOUR_API_KEY` header is also supported for current clients.

Include the key on every authenticated request.

```bash theme={null}
curl "https://api.kanarie.xyz/api/v1/projects/search?type=name&q=Jupiter" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

Droyd API keys are no longer accepted by the Kanarie API.

## Playground auth

In the API reference, paste your key into the auth field. Mintlify will include the header when you click **Send**.

## Authentication errors

Common authentication failures:

| Status | Cause                                                                                                                       |
| ------ | --------------------------------------------------------------------------------------------------------------------------- |
| `401`  | Missing, malformed, invalid, revoked, or expired API key on API-key-only paths                                              |
| `402`  | x402 payment is required for no-key requests, failed API-key requests, or over-limit API-key requests on x402-enabled paths |
| `429`  | Rate limit exceeded on API-key-only paths                                                                                   |

Valid API keys without an active paid subscription use the free tier limits.

<Note>
  Kanarie has an internal service-key path for trusted backend calls. It is not part of the public API and is intentionally excluded from public docs.
</Note>