Skip to main content

​
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
  • Plan for batch size: up to 10,000 emails per job
  • File uploads support .txt, .csv, .xlsx
All API requests require authorization headers. Use Authorization: Bearer <api_key> (recommended) or X-API-Key: <api_key>.

​
Choose your path

API developers

Verify a single address, then create a batch job via API.

File upload (ops)

Upload a list and download results with minimal setup.

​
API developers

export BOLTROUTE_API_KEY="your_api_key_here"

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"}'

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"
  }'
Track status and download results with Get batch verification task and Download batch verification results. For completion callbacks, see Webhooks.

​
File upload (ops)

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'
email_column is optional and not supported for .txt uploads. Maximum 10,000 emails per file.
curl -X GET \
  'https://api.boltroute.ai/api/v1/tasks/batch/uploads/<upload_id>' \
  -H "Authorization: Bearer $BOLTROUTE_API_KEY"

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
You can download results as csv, txt, or xlsx. See Download batch verification results.

​
Compatibility

Context7

Docs are already indexed and ready to use in Context7.

DeepWiki

Use the pre-indexed bolt-core/docs source in DeepWiki.

LLMs.txt

LLM tools can discover the docs via the official llms.txt.

​
Next steps

API reference

Explore all endpoints and schemas.

Integrations

Connect Bolt Route to your existing workflows.