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

# Authentication

> Every Nexus API request must carry a valid API key

Every request must include an `x-api-key` header containing a valid API key. API keys are issued during onboarding.

```bash theme={null}
curl https://your-nexus-host/v1/stations \
  -H "x-api-key: your-api-key"
```

## Failure modes

| Condition | Response |
| - | - |
| API key missing | `401 Unauthorized` |
| API key not recognised | `401 Unauthorized` |

> [!NOTE]
>
> The API is designed for server-to-server use. Because the API key is the credential on the request, it should stay on your backend and never be
> shipped in an end-user application.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.