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

# Authorization

> Authorize requests with your API key.

## API key usage

Use your API key to authorize every request. Keep it secret and send it using one of the headers below.

<Card title="Create an API key" icon="key" href="/api-reference/endpoints/api-keys/create-key" cta="Create API key">
  Generate a new API key to authorize requests.
</Card>

### Authorization header (recommended)

```text theme={null}
Authorization: Bearer <api_key>
```

### X-API-Key header

```text theme={null}
X-API-Key: <api_key>
```

## Example

```bash theme={null}
curl -X POST \
  'https://api.boltroute.ai/api/v1/verify' \
  -H 'Authorization: Bearer <api_key>' \
  -H 'Content-Type: application/json' \
  -d '{"email":"user@example.com"}'
```

## Try authorization

<CardGroup cols={2}>
  <Card title="Realtime verification" icon="bolt" href="/api-reference/endpoints/realtime-verification" cta="Try endpoint">
    Verify a single email in real time.
  </Card>

  <Card title="Batch verification" icon="list-check" href="/api-reference/endpoints/batch-verification/create-task" cta="Create task">
    Submit a batch verification job.
  </Card>

  <Card title="File upload" icon="file-arrow-up" href="/api-reference/endpoints/file-upload/upload-file" cta="Upload file">
    Upload a CSV/XLSX for batch verification.
  </Card>

  <Card title="API keys" icon="key" href="/api-reference/endpoints/api-keys/create-key" cta="Create key">
    Generate a new API key.
  </Card>
</CardGroup>

<Note>
  All endpoints in this reference require authorization unless explicitly stated. Endpoint examples omit authorization headers for brevity.
</Note>