> ## 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.

# Quickstart

> Verify your first email in minutes via API or file upload.

## What you'll do

Verify a single email in real time or process a batch list and download results.

## Before you begin

* Create an API key: [Authorization](/api-reference/authorization)
* Plan for batch size: up to 10,000 emails per job
* File uploads support `.txt`, `.csv`, `.xlsx`

<Note>
  All API requests require authorization headers. Use `Authorization: Bearer <api_key>` (recommended) or `X-API-Key: <api_key>`.
</Note>

## Choose your path

<CardGroup cols={2}>
  <Card title="API developers" icon="bolt" href="#api-developers">
    Verify a single address, then create a batch job via API.
  </Card>

  <Card title="File upload (ops)" icon="file-arrow-up" href="#file-upload-ops">
    Upload a list and download results with minimal setup.
  </Card>
</CardGroup>

## API developers

<AccordionGroup>
  <Accordion title="Step 1: Set your API key" icon="key">
    ```bash theme={null}
    export BOLTROUTE_API_KEY="your_api_key_here"
    ```
  </Accordion>

  <Accordion title="Step 2: Verify one email" icon="bolt">
    ```bash theme={null}
    curl -X POST \
      'https://api.boltroute.ai/api/v1/verify' \
      -H "Authorization: Bearer $BOLTROUTE_API_KEY" \
      -H 'Content-Type: application/json' \
      -d '{"email":"user@example.com"}'
    ```
  </Accordion>

  <Accordion title="Step 3: Create a batch job" icon="list-check">
    ```bash theme={null}
    curl -X POST \
      'https://api.boltroute.ai/api/v1/tasks' \
      -H "Authorization: Bearer $BOLTROUTE_API_KEY" \
      -H 'Content-Type: application/json' \
      -d '{
        "emails": ["user1@example.com", "user2@example.com"],
        "webhook_url": "https://example.com/webhook"
      }'
    ```
  </Accordion>
</AccordionGroup>

<Tip>
  Track status and download results with [Get batch verification task](/api-reference/endpoints/batch-verification/get-task) and [Download batch verification results](/api-reference/endpoints/batch-verification/download-results). For completion callbacks, see [Webhooks](/api-reference/webhooks).
</Tip>

## File upload (ops)

<AccordionGroup>
  <Accordion title="Step 1: Upload your list" icon="file-arrow-up">
    ```bash theme={null}
    curl -X POST \
      'https://api.boltroute.ai/api/v1/tasks/batch/upload' \
      -H "Authorization: Bearer $BOLTROUTE_API_KEY" \
      -F 'file=@emails.csv' \
      -F 'email_column=email'
    ```

    <Note>
      `email_column` is optional and not supported for `.txt` uploads. Maximum 10,000 emails per file.
    </Note>
  </Accordion>

  <Accordion title="Step 2: Check upload status" icon="list-check">
    ```bash theme={null}
    curl -X GET \
      'https://api.boltroute.ai/api/v1/tasks/batch/uploads/<upload_id>' \
      -H "Authorization: Bearer $BOLTROUTE_API_KEY"
    ```
  </Accordion>

  <Accordion title="Step 3: Download results" icon="download">
    ```bash theme={null}
    curl -L \
      'https://api.boltroute.ai/api/v1/tasks/<task_id>/download?format=csv' \
      -H "Authorization: Bearer $BOLTROUTE_API_KEY" \
      -o batch-verification-results.csv
    ```
  </Accordion>
</AccordionGroup>

<Tip>
  You can download results as `csv`, `txt`, or `xlsx`. See [Download batch verification results](/api-reference/endpoints/batch-verification/download-results).
</Tip>

## Compatibility

<CardGroup cols={3}>
  <Card title="Context7" icon="book-open-cover" href="/guides/context7-compatibility">
    Docs are already indexed and ready to use in Context7.
  </Card>

  <Card title="DeepWiki" icon="book-open-cover" href="/guides/deepwiki-compatibility">
    Use the pre-indexed `bolt-core/docs` source in DeepWiki.
  </Card>

  <Card title="LLMs.txt" icon="file-text" href="/guides/llms-txt">
    LLM tools can discover the docs via the official `llms.txt`.
  </Card>
</CardGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="API reference" icon="code" href="/api-reference/introduction">
    Explore all endpoints and schemas.
  </Card>

  <Card title="Integrations" icon="plug" href="/integrations/zapier">
    Connect Bolt Route to your existing workflows.
  </Card>
</CardGroup>