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

# Authentication

> Authenticate API requests with your Bearer API key.

Send your key as a Bearer token. Keys look like `bpk_xxxxxxxx_...`. We email your key to you when your account is created.

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

The header `X-API-Key: bpk_...` is also accepted as an alternative.

> [!WARNING]
>
> The API key is for this API only. Our Telegram bot does **not** use it: the bot has its own one-time bot code (`bpt_...`, in the same email), so never send your API key to the bot. See [Telegram bot](https://docs.balaipedia.com/telegram-bot.md).

## Lost or leaked keys

If you lose the key or it leaks, ask us to generate a new one: we email it to you and the old key stops working immediately. Your Telegram bot access is not affected.

## IP restriction

Optional: we can restrict your key to specific server IP addresses. Ask support.


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