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

# Company Distribution by Country

> Returns the distribution of a company's employees grouped by ISO 3166-1 alpha-2 country code.

<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:** 1 credit per call on Trial Plan
</Callout>

<Callout icon="coin" color="orange">
  **Free** on the Unlimited plan
</Callout>

Get the geographic distribution of a company's employees, grouped by country, from a LinkedIn company URL. Each bucket returns both a `count` and a `percentage_ratio` — the bucket's share of `total_employees` (0–100, to 2 decimals).

<Note>
  Countries are reported as ISO 3166-1 alpha-2 codes (e.g. `US`, `GB`). Employees whose country could not be determined are grouped under `unknown`.
</Note>

<Tip>
  If you only have a domain, run **Domain to Linkedin URL** first, then pipe the LinkedIn URL into this endpoint.
</Tip>


## OpenAPI

````yaml api-reference/v2.openapi.json POST /v2/enrichment/company-distribution-by-country
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/enrichment/company-distribution-by-country:
    post:
      tags:
        - Company Enrichment
      summary: Company Distribution by Country
      description: >-
        Returns the distribution of a company's employees grouped by ISO 3166-1
        alpha-2 country code.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                company_linkedin_url:
                  type: string
                  example: https://www.linkedin.com/company/openai
              required:
                - company_linkedin_url
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                example:
                  company_linkedin_url: https://www.linkedin.com/company/openai
                  total_employees: 1234
                  distribution:
                    - country: US
                      count: 900
                      percentage_ratio: 72.93
                    - country: GB
                      count: 200
                      percentage_ratio: 16.21
                    - country: FR
                      count: 80
                      percentage_ratio: 6.48
                    - country: unknown
                      count: 54
                      percentage_ratio: 4.38
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                example:
                  success: false
                  message: >-
                    Invalid API key, please provide a valid API key in the
                    'x-api-key' header
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                type: object
                example:
                  success: false
                  message: Rate limit exceeded, please try again later
      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

````