Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.blitz-api.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Authentication

How to securely authenticate your requests with BlitzAPI.
Agents & LLMs: a Markdown version of this page is available by appending .md to the URL, and the full documentation index is at llms.txt.
BlitzAPI uses API Keys to authenticate requests. You can view and manage your API keys in the BlitzAPI Dashboard.

​
The x-api-key Header

Authentication to the API is handled via an HTTP header. Include your API key in every request using the x-api-key header.
Security Warning: Your API keys carry many privileges. Do not use your API keys in client-side code (browsers, mobile apps).Always route requests through your own backend server to keep your keys secret.

​
Example Request

Here is how to set the header in various environments: 
curl "https://api.blitz-api.ai/v2/account/key-info" \
 -H "x-api-key: YOUR_API_KEY"

​
Verifying your Key

To check if your key is active, use the GET /v2/account/key-info endpoint. This is a great way to “health check” your integration before running batch jobs. Response: 
{
  "valid": true,
  "id": "key_abc123",
  "remaining_credits": 99.5,
  "next_reset_at": "2026-02-12T17:48:25.199Z",
  "max_requests_per_seconds": 5,
  "allowed_apis": [
    "/search/waterfall-icp-keyword",
    "/enrichment/email",
    "/enrichment/phone"
  ],
  "active_plans": [
    {
      "name": "Unlimited Leads",
      "status": "active",
      "started_at": "2026-01-12T17:48:25.200Z"
    }
  ]
}
Response Fields:
FieldTypeDescription
validbooleantrue if the key is active and can make requests.
idstringInternal identifier for your API key.
remaining_creditsnumberRemaining usage allowance. Relevant for trial accounts only — paid plans are unlimited.
next_reset_atstringISO 8601 timestamp of when your allowance resets.
max_requests_per_secondsintegerYour plan’s rate limit. Use this value to configure your rate limiter client-side.
allowed_apisarrayList of endpoint paths your key is authorized to call.
active_plansarrayYour active subscription(s) with name, status, and start date.

​
Errors

If authentication fails, the API will return a 401 Unauthorized error.
CodeMeaningSolution
401UnauthorizedMissing or invalid API key. Check that the x-api-key header is present and correct.
402Payment RequiredYour key is valid, but your account has reached its limit. Upgrade your plan.
404Not FoundThe API Key provided does not exist in our system.