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

# Authentication

> How to authenticate requests to Waterfall API.

All requests are authenticated using `x-api-key`.

```bash theme={null}
x-api-key: <your-api-key>
```

<Note>
  Base API URL is `https://api.waterfall.io/v1/` for v1 endpoints. Account reporter v2 uses `/v2/account`.
</Note>

## Best practices

* Store keys in environment variables.
* Rotate keys periodically.
* Use dedicated keys per team/workflow when possible.