> ## Documentation Index
> Fetch the complete documentation index at: https://docs.companyenrich.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Batch enrich

> **Cost:** 1 credit per unique domain successfully enriched

Enriches a list of companies using their domain names. Up to 50 domains can be provided in a single request.

Domains that could not be enriched return null and do not consume credits. Duplicate domains are charged only once.

We map each domain to a unique company so lookups via domain are fast and reliable.
It is the preferred way to enrich a company.

Batching is recommended for larger lists of domains. It allows you to enrich multiple companies in a single request.
Eliminating the need to make multiple requests to the API. Also the rate limiter would be able to handle more requests.



## OpenAPI

````yaml openapi/v1.json POST /companies/enrich/batch
openapi: 3.0.4
info:
  title: Company Enrich API
  description: >-
    The Company Enrich API provides programmatic access to a comprehensive
    database of company and person data for enrichment, search, and lead
    generation.


    ## Key Features


    - **Company Enrichment** — Enrich company profiles by domain, ID, or
    matching properties. Supports single lookups, batch requests, and bulk
    background jobs.

    - **Company Search** — Search and filter companies by industry, location,
    size, technology usage, keywords, and more. Supports page-based,
    cursor-based, and async export pagination.

    - **People Search** — Search for professionals by job title, company,
    location, and other criteria. Export results in CSV or JSON.

    - **Similar Companies** — Find companies similar to a given company based on
    shared attributes.

    - **Company Lists** — Create and manage saved lists of companies for
    organizing and exporting your data.


    ## Authentication


    All API requests require a Bearer token passed in the `Authorization`
    header:


    ```

    Authorization: Bearer YOUR_API_TOKEN

    ```


    You can generate API tokens from your
    [dashboard](https://companyenrich.com/dashboard).


    ## Credits


    Most API calls consume credits. The credit cost for each endpoint is
    documented in its description. You can check your remaining credit balance
    using the User endpoint.


    ## Rate Limiting


    The global API limiter allows **500 requests per minute** per IP address.
    Authenticated API routes also use a per-user route limiter based on plan
    capabilities.

    Supplementary lookup endpoints (such as keyword/technology/industry
    autocompletes) use a separate per-user route-level bucket.
  termsOfService: https://companyenrich.com/terms-and-conditions
  contact:
    url: https://companyenrich.com/
    email: support@companyenrich.com
  version: 1.0.0
servers:
  - url: https://api.companyenrich.com
security:
  - Bearer: []
tags:
  - name: Company / Enrichment
    description: >-
      Enrich company data by domain, properties, or in batch. Get company
      details by ID.
  - name: Company / Bulk Enrichment
    description: >-
      Create and manage asynchronous bulk enrichment jobs for large domain
      lists.
  - name: Company / Search
    description: Search companies by filters with pagination and cursor scrolling.
  - name: Company / Export
    description: Create and manage asynchronous company search export jobs.
  - name: Company / Similar
    description: Find companies similar to a given company by domain or ID.
  - name: People / Search
    description: >-
      Search people by various criteria with page-based or cursor-based
      pagination.
  - name: People / Enrichment
    description: >-
      Resolve work email addresses for individual people in realtime or
      background jobs.
  - name: People / Export
    description: Create and manage asynchronous people search export jobs.
  - name: Jobs
    description: >-
      Endpoints for listing and monitoring background processing jobs such as
      bulk enrichments and async exports.
  - name: Company / Lists
    description: Endpoints for creating and managing company lists and export lists.
  - name: Geo
    description: >-
      Endpoints for looking up geographic data including regions, countries,
      states, and cities.
  - name: Industries
    description: >-
      Endpoints for listing available industry classifications used in company
      search filters.
  - name: Keywords
    description: Endpoints for looking up keywords used in company search filters.
  - name: Technologies
    description: Endpoints for looking up technologies used in company search filters.
  - name: User
    description: >-
      Endpoints for retrieving information about the authenticated user,
      including credit balance and account details.
  - name: Positions
    description: >-
      Endpoints for looking up job positions and titles used in people search
      filters.
paths:
  /companies/enrich/batch:
    post:
      tags:
        - Company / Enrichment
      summary: Batch enrich
      description: >-
        **Cost:** 1 credit per unique domain successfully enriched


        Enriches a list of companies using their domain names. Up to 50 domains
        can be provided in a single request.


        Domains that could not be enriched return null and do not consume
        credits. Duplicate domains are charged only once.


        We map each domain to a unique company so lookups via domain are fast
        and reliable.

        It is the preferred way to enrich a company.


        Batching is recommended for larger lists of domains. It allows you to
        enrich multiple companies in a single request.

        Eliminating the need to make multiple requests to the API. Also the rate
        limiter would be able to handle more requests.
      parameters:
        - name: expand
          in: query
          description: >-
            Expandable response fields. Repeat the parameter to request multiple
            expansions.


            Supported values:

            - `workforce`: costs 5 credits per company and adds the `workforce`
            field to `CompanyInfo`.
          schema:
            type: array
            items:
              enum:
                - workforce
              type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchEnrichRequest'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/CompanyInfo'
        '400':
          description: Bad Request
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '401':
          description: Unauthorized
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '402':
          description: Payment Required
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '422':
          description: Unprocessable Entity
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/HttpValidationProblemDetails'
        '429':
          description: Too Many Requests
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
components:
  schemas:
    BatchEnrichRequest:
      required:
        - domains
      type: object
      properties:
        domains:
          maxItems: 50
          minItems: 1
          type: array
          items:
            type: string
          description: >-
            A list of domains to enrich. Up to 50 domains can be provided in a
            single request.
    CompanyInfo:
      required:
        - id
      type: object
      properties:
        id:
          type: string
          description: The unique identifier of the company
          format: uuid
        name:
          maxLength: 1024
          type: string
          description: The name of the company
          nullable: true
        domain:
          maxLength: 1024
          type: string
          description: The primary domain name of the company
          nullable: true
        website:
          type: string
          description: The website URL of the company
          format: uri
          nullable: true
        type:
          $ref: '#/components/schemas/NullableOfCompanyType'
        legalName:
          type: string
          description: The legal name of the company
          nullable: true
        industry:
          type: string
          description: The main industry of the company
          nullable: true
        industries:
          type: array
          items:
            type: string
          description: The industries associated with the company
          nullable: true
        categories:
          type: array
          items:
            $ref: '#/components/schemas/CompanyCategory'
          description: The categories of the company from most to least specific.
          nullable: true
        employees:
          $ref: '#/components/schemas/NullableOfCompanyEmployees'
        reported_employees:
          $ref: '#/components/schemas/NullableOfCompanyEmployees2'
        revenue:
          $ref: '#/components/schemas/NullableOfCompanyRevenue'
        description:
          type: string
          description: The description of the company
          nullable: true
        keywords:
          type: array
          items:
            type: string
          description: The search keywords of the company
          nullable: true
        technologies:
          type: array
          items:
            type: string
          description: The technologies associated with the company
          nullable: true
        subsidiaries:
          type: array
          items:
            type: string
          description: The subsidiaries associated with the company
          nullable: true
        founded_year:
          type: integer
          description: The year the company was founded
          format: int32
          nullable: true
        naics_codes:
          type: array
          items:
            type: string
          description: The NAICS codes associated with the company
          nullable: true
        location:
          $ref: '#/components/schemas/CompanyLocationInfo'
        financial:
          $ref: '#/components/schemas/CompanyFinancialInfo'
        socials:
          $ref: '#/components/schemas/CompanySocialUrls'
        page_rank:
          type: number
          description: The page rank of the company
          format: float
          nullable: true
        workforce:
          $ref: '#/components/schemas/CompanyWorkforceInfo'
        logo_url:
          type: string
          description: The logo URL of the company
          nullable: true
        seo_description:
          type: string
          description: The SEO description of the company
          nullable: true
        updated_at:
          type: string
          description: The last updated timestamp of the company
          format: date-time
    ProblemDetails:
      type: object
      properties:
        type:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        status:
          type: integer
          format: int32
          nullable: true
        detail:
          type: string
          nullable: true
        instance:
          type: string
          nullable: true
    HttpValidationProblemDetails:
      type: object
      properties:
        type:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        status:
          type: integer
          format: int32
          nullable: true
        detail:
          type: string
          nullable: true
        instance:
          type: string
          nullable: true
        errors:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
    NullableOfCompanyType:
      enum:
        - unknown
        - private
        - public
        - self-employed
        - self-owned
        - partnership
        - nonprofit
        - educational
        - government
        - null
      description: The type of the company
      nullable: true
    CompanyCategory:
      enum:
        - b2b
        - b2c
        - b2g
        - e-commerce
        - media
        - service-provider
        - mobile
        - saas
        - local-business
    NullableOfCompanyEmployees:
      enum:
        - 1-10
        - 11-50
        - 51-200
        - 201-500
        - 501-1K
        - 1K-5K
        - 5K-10K
        - over-10K
        - null
      description: The employee count range.
      nullable: true
    NullableOfCompanyEmployees2:
      enum:
        - 1-10
        - 11-50
        - 51-200
        - 201-500
        - 501-1K
        - 1K-5K
        - 5K-10K
        - over-10K
        - null
      description: The employee count range reported by external data providers.
      nullable: true
    NullableOfCompanyRevenue:
      enum:
        - under-1m
        - 1m-10m
        - 10m-50m
        - 50m-100m
        - 100m-200m
        - 200m-1b
        - over-1b
        - null
      description: The range of annual revenue of the company in USD
      nullable: true
    CompanyLocationInfo:
      type: object
      properties:
        country:
          $ref: '#/components/schemas/CountryInfo'
        state:
          $ref: '#/components/schemas/StateInfo'
        city:
          $ref: '#/components/schemas/CityInfo'
        address:
          type: string
          nullable: true
        postal_code:
          type: string
          nullable: true
        phone:
          type: string
          nullable: true
      description: The location information of the company
      nullable: true
    CompanyFinancialInfo:
      type: object
      properties:
        stock_symbol:
          type: string
          nullable: true
        stock_exchange:
          type: string
          nullable: true
        total_funding:
          type: integer
          format: int64
          nullable: true
        funding_stage:
          type: string
          nullable: true
        funding_date:
          type: string
          format: date-time
          nullable: true
        funding:
          type: array
          items:
            $ref: '#/components/schemas/CompanyFundingInfo'
          nullable: true
      description: The financial information of the company
      nullable: true
    CompanySocialUrls:
      type: object
      properties:
        linkedin_url:
          type: string
          description: The LinkedIn URL of the company
          format: uri
          nullable: true
        linkedin_id:
          maxLength: 1024
          type: string
          description: The LinkedIn ID of the company
          nullable: true
        twitter_url:
          type: string
          description: The Twitter URL of the company
          format: uri
          nullable: true
        facebook_url:
          type: string
          description: The Facebook URL of the company
          format: uri
          nullable: true
        instagram_url:
          type: string
          description: The Instagram URL of the company
          format: uri
          nullable: true
        angellist_url:
          type: string
          description: The AngelList URL of the company
          format: uri
          nullable: true
        crunchbase_url:
          type: string
          description: The Crunchbase URL of the company
          format: uri
          nullable: true
        youtube_url:
          type: string
          description: The YouTube URL of the company
          format: uri
          nullable: true
        github_url:
          type: string
          description: The GitHub URL of the company
          format: uri
          nullable: true
        g2_url:
          type: string
          description: The G2 URL of the company
          format: uri
          nullable: true
      description: The social URLs of the company
    CompanyWorkforceInfo:
      required:
        - company_id
        - domain
        - department_headcount
      type: object
      properties:
        company_id:
          type: string
          description: The CompanyEnrich ID of the company.
          format: uuid
        domain:
          type: string
          description: The canonical domain of the company.
        observed_employee_count:
          type: integer
          description: Observed number of distinct current employees in our people dataset.
          format: int32
        employee_count_range:
          $ref: '#/components/schemas/NullableOfCompanyEmployees'
        department_headcount:
          $ref: '#/components/schemas/CompanyWorkforceDepartmentHeadcount'
        unclassified_headcount:
          type: integer
          description: Headcount where department could not be classified.
          format: int32
        history:
          type: array
          items:
            $ref: '#/components/schemas/CompanyWorkforceHistoryEntry'
          description: >-
            Monthly workforce snapshots showing headcount changes over time.
            Only months where headcount changed are included.
          nullable: true
      description: >-
        Expanded workforce insights for the company. This field is only returned
        when `expand=workforce` is requested.
      nullable: true
    CountryInfo:
      type: object
      properties:
        code:
          type: string
          description: The ISO 3166-1 alpha-2 code of the country
        name:
          type: string
          description: The name of the country
        latitude:
          type: number
          description: The latitude of the country
          format: float
          nullable: true
        longitude:
          type: number
          description: The longitude of the country
          format: float
          nullable: true
      description: The origin country information of the company
      nullable: true
    StateInfo:
      type: object
      properties:
        id:
          type: integer
          description: The ID of the state
          format: int32
        name:
          type: string
          description: The name of the state
        code:
          type: string
          description: The ISO 3166-2 code of the state
          nullable: true
        latitude:
          type: number
          description: The latitude of the state
          format: float
          nullable: true
        longitude:
          type: number
          description: The longitude of the state
          format: float
          nullable: true
      description: The state information of the company
      nullable: true
    CityInfo:
      type: object
      properties:
        id:
          type: integer
          description: The ID of the city
          format: int32
        name:
          type: string
          description: The name of the city
        latitude:
          type: number
          description: The latitude of the city
          format: float
          nullable: true
        longitude:
          type: number
          description: The longitude of the city
          format: float
          nullable: true
      description: The city information of the company
      nullable: true
    CompanyFundingInfo:
      type: object
      properties:
        date:
          type: string
          format: date-time
          nullable: true
        amount:
          type: string
          nullable: true
        type:
          type: string
          nullable: true
        url:
          type: string
          nullable: true
        from:
          type: string
          nullable: true
    CompanyWorkforceDepartmentHeadcount:
      type: object
      properties:
        c_suite:
          type: integer
          description: Headcount in the c-suite root department.
          format: int32
          nullable: true
        product_management:
          type: integer
          description: Headcount in the product management root department.
          format: int32
          nullable: true
        engineering_technical:
          type: integer
          description: Headcount in the engineering and technical root department.
          format: int32
          nullable: true
        design:
          type: integer
          description: Headcount in the design root department.
          format: int32
          nullable: true
        education:
          type: integer
          description: Headcount in the education root department.
          format: int32
          nullable: true
        finance:
          type: integer
          description: Headcount in the finance root department.
          format: int32
          nullable: true
        human_resources:
          type: integer
          description: Headcount in the human resources root department.
          format: int32
          nullable: true
        information_technology:
          type: integer
          description: Headcount in the information technology root department.
          format: int32
          nullable: true
        legal:
          type: integer
          description: Headcount in the legal root department.
          format: int32
          nullable: true
        marketing:
          type: integer
          description: Headcount in the marketing root department.
          format: int32
          nullable: true
        medical_health:
          type: integer
          description: Headcount in the medical and health root department.
          format: int32
          nullable: true
        operations:
          type: integer
          description: Headcount in the operations root department.
          format: int32
          nullable: true
        sales:
          type: integer
          description: Headcount in the sales root department.
          format: int32
          nullable: true
        consulting:
          type: integer
          description: Headcount in the consulting root department.
          format: int32
          nullable: true
      description: Headcount grouped by root department name.
    CompanyWorkforceHistoryEntry:
      required:
        - date
        - department_headcount
      type: object
      properties:
        date:
          type: string
          description: First day of the month for this snapshot.
          format: date
        observed_employee_count:
          type: integer
          description: >-
            Observed number of distinct employees in our people dataset for this
            month.
          format: int32
        employee_count_range:
          $ref: '#/components/schemas/NullableOfCompanyEmployees'
        department_headcount:
          $ref: '#/components/schemas/CompanyWorkforceDepartmentHeadcount'
        unclassified_headcount:
          type: integer
          description: Headcount where department could not be classified.
          format: int32
  securitySchemes:
    Bearer:
      type: apiKey
      description: >-
        API Token used for authentication. Example: "Authorization: Bearer
        {token}"
      name: Authorization
      in: header
      x-bearer-format: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.