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

# Get API Key Details

> Check API key validity, remaining credits, rate limit, allowed endpoints, and active subscription plans.

<div style={{position:'absolute',width:'1px',height:'1px',padding:0,margin:'-1px',overflow:'hidden',clipPath:'inset(50%)',whiteSpace:'nowrap',border:0}}>
  > **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](https://docs.blitz-api.ai/llms.txt).
</div>

<Callout icon="coin" color="blue">
  **Cost:** no cost
</Callout>

<Tip>
  Use this as a **health check** before running batch jobs. A 200 response confirms the key is valid, and the credit balance covers the run.
</Tip>

<Card title="Authentication" icon="key" href="/guide/getting-started/authentication">
  How to provision and use the `x-api-key` header across BlitzAPI endpoints.
</Card>


## OpenAPI

````yaml api-reference/v2.openapi.json GET /v2/account/key-info
openapi: 3.1.0
info:
  title: Blitz API Reference
  version: 2.0.0
  description: >-
    Welcome to the Blitz API Reference.


    Use this interactive documentation to explore and test every v2 endpoint.
    Authentication is required via the `x-api-key` header.


    **Base URL**: `https://api.blitz-api.ai`


    **Rate limit**: 5 requests per second, per endpoint (all plans). Each
    endpoint has its own independent budget, so different endpoints don't share
    the limit.


    **Pricing**: All endpoints are unlimited on paid plans ($399+/mo). Free
    trial accounts receive 1,000 credits.
servers:
  - url: https://api.blitz-api.ai
    description: Production server
security: []
tags:
  - name: Account
    description: API key info and health check.
  - name: Waterfall ICP Search
    description: Priority-based cascade search — find the best-match contact at a company.
  - name: Employee Finder
    description: Browse all employees at a single company with filters.
  - name: Company Search
    description: Search companies by industry, size, location, and keywords.
  - name: People Enrichment
    description: Enrich contacts with verified emails, phones, and reverse lookups.
  - name: Company Enrichment
    description: Enrich companies and resolve domain ↔ LinkedIn URL.
  - name: Utilities
    description: Helper endpoints (current date/time).
paths:
  /v2/account/key-info:
    get:
      tags:
        - Account
      summary: Get API Key Details
      description: >-
        Check API key validity, remaining credits, rate limit, allowed
        endpoints, and active subscription plans.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                example:
                  valid: true
                  id: XXX
                  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_domain
                    - /enrichment/email
                  active_plans:
                    - name: Startup Trial
                      status: active
                      started_at: '2026-01-12T17:48:25.200Z'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                example:
                  message: >-
                    Missing API key, please provide a valid API key in the
                    'x-api-key' header
        '404':
          description: Not found
          content:
            application/json:
              schema:
                type: object
                example:
                  message: API Key not found
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                example:
                  success: false
                  message: >-
                    this is a controlled error. created at
                    2025-07-11T10:20:00.000Z
      security:
        - APIKey: []
components:
  securitySchemes:
    APIKey:
      type: apiKey
      in: header
      name: x-api-key
      description: Your Blitz API Key. Get one from https://app.blitz-api.ai

````