---
title: "Bulk Organization Enrichment"
method: POST
path: "/organizations/bulk_enrich"
tags: ["Enrichment"]
---

# Bulk Organization Enrichment

`POST /organizations/bulk_enrich`

This endpoint consumes **1 Apollo credit per organization** when an organization/company is matched or found. If Apollo doesn't find a matching organization, that organization consumes **0 credits**. Learn more about [API pricing and credits](https://docs.apollo.io/docs/api-pricing).

<a href="https://knowledge.apollo.io/hc/en-us/articles/33699917233293-Enrichment-Overview" target="_blank">Enrichment</a> is when you refresh existing records so your prospecting data is up-to-date.<br><br>Use the Bulk Organization Enrichment endpoint to enrich data for up to ten companies with a single API call. To enrich data for a single company, use the <a href="https://docs.apollo.io/reference/organization-enrichment">Organization Enrichment endpoint</a> instead.<br><br>You can identify the companies to enrich by providing a list of domains via the <code>domains[]</code> query parameter, or by providing a <code>details</code> array in the request body where each company can be matched by any combination of domain, LinkedIn URL, name, and website.<br><br>Enriched data potentially includes industry information, revenue, employee counts, funding round details, corporate phone numbers, locations, language counts, retail-location counts, and organization hierarchy data. The <code>owned_by_organization</code> field identifies the immediate parent, <code>owned_by_chain</code> lists parent organization IDs from the immediate parent to the ultimate parent, and <code>ultimate_parent_organization</code> identifies the topmost parent. Each result also includes <code>num_suborganizations</code> and <code>subsidiary_rollups</code> with the total estimated subsidiary employee count and distinct subsidiary countries and industries.

## Query parameters

- `domains[]` string[]

## Request body

- object
  - `details` object[] — Provide info for each company you want to enrich as an object within this array. Add up to 10 companies. Each object can include any combination of `domain`, `linkedin_url`, `name`, and `website`. Providing more than one value for a company improves match accuracy. <br><br>If you provide a `details` payload, it takes precedence over the `domains[]` query parameter.
    - `domain` string — The domain of the company that you want to enrich. Do not include `www.`, the `@` symbol, or similar. <br><br>Example: `apollo.io` or `microsoft.com`
    - `linkedin_url` string — The URL for the company's LinkedIn profile. <br><br>Example: `http://www.linkedin.com/company/apolloio`
    - `name` string — The name of the company that you want to enrich. <br><br>Example: `apollo`
    - `website` string — The full website URL of the company that you want to enrich. <br><br>Example: `http://www.apollo.io`

## Response `200`

200

- object
  - `status` string
  - `error_code` unknown
  - `error_message` unknown
  - `total_requested_records` integer — The total number of companies submitted in the `details` payload, including duplicates. Returned only when you enrich using the `details` request body; `null` for `domains[]` requests.
  - `total_requested_domains` integer — The total number of domains submitted via the `domains[]` query parameter, including duplicates. Returned only for `domains[]` requests; `null` when you enrich using the `details` payload.
  - `unique_domains` integer — The number of unique domains submitted via the `domains[]` query parameter. Returned only for `domains[]` requests; `null` when you enrich using the `details` payload.
  - `unique_records` integer — The number of unique companies submitted in the `details` payload after de-duplication. Returned only when you enrich using the `details` request body; `null` for `domains[]` requests.
  - `unique_enriched_records` integer
  - `missing_records` integer
  - `organizations` object[]
    - `id` string
    - `name` string
    - `website_url` string
    - `blog_url` unknown
    - `angellist_url` unknown
    - `linkedin_url` string
    - `twitter_url` string
    - `facebook_url` string
    - `primary_phone` object
    - `languages` string[] — The distinct languages associated with the organization.
    - `num_languages` integer — The number of distinct values in `languages`.
    - `alexa_ranking` integer
    - `phone` unknown
    - `linkedin_uid` string
    - `founded_year` integer
    - `publicly_traded_symbol` unknown
    - `publicly_traded_exchange` unknown
    - `logo_url` string
    - `crunchbase_url` unknown
    - `primary_domain` string
    - `industry` string
    - `keywords` string[]
    - `estimated_num_employees` integer
    - `industries` string[]
    - `secondary_industries` unknown[]
      - unknown
    - `snippets_loaded` boolean
    - `industry_tag_id` string
    - `industry_tag_hash` object
      - `information technology & services` string
    - `retail_location_count` integer
    - `num_retail_locations` integer — The number of retail company locations that aren't marked as closed.
    - `raw_address` string
    - `street_address` string
    - `city` string
    - `state` string
    - `country` string
    - `postal_code` string
    - `owned_by_organization_id` unknown
    - `owned_by_organization` object — The immediate parent organization. Omitted when the organization has no parent.
      - `id` string
      - `name` string
      - `website_url` string
    - `owned_by_chain` string[] — Apollo organization IDs in the ownership chain, ordered from the immediate parent to the ultimate parent. Omitted when the organization has no ownership chain.
    - `ultimate_parent_organization` object — The topmost parent in the ownership chain. Omitted when the organization has no ultimate parent.
      - `id` string
      - `name` string
      - `website_url` string
    - `num_suborganizations` integer — The number of subsidiaries directly owned by the organization.
    - `subsidiary_rollups` object — Aggregated firmographic data for subsidiaries directly owned by the organization. Returns zero and empty arrays when no subsidiary data is available.
      - `total_estimated_employee_count` integer — The sum of estimated employee counts across the organization's subsidiaries.
      - `countries` string[] — Distinct countries represented by the organization's subsidiaries.
      - `industries` string[] — Distinct industries represented by the organization's subsidiaries.
    - `seo_description` string
    - `short_description` string
    - `account_id` string
    - `account` object
      - `id` string
      - `domain` string
      - `name` string
      - `team_id` string
      - `organization_id` string
      - `account_stage_id` unknown
      - `source` string
      - `original_source` string
      - `creator_id` unknown
      - `owner_id` string
      - `created_at` string
      - `phone` string
      - `phone_status` string
      - `hubspot_id` unknown
      - `salesforce_id` unknown
      - `crm_owner_id` unknown
      - `parent_account_id` unknown
      - `linkedin_url` unknown
      - `sanitized_phone` string
      - `account_playbook_statuses` unknown[]
        - unknown
      - `account_rule_config_statuses` unknown[]
        - unknown
      - `existence_level` string
      - `label_ids` string[]
      - `typed_custom_fields` object
      - `custom_field_errors` unknown
      - `modality` string
      - `source_display_name` string
      - `crm_record_url` unknown
      - `intent_strength` unknown
      - `show_intent` boolean
      - `has_intent_signal_account` boolean
      - `intent_signal_account` unknown
    - `departmental_head_count` object
      - `engineering` integer
      - `operations` integer
      - `support` integer
      - `marketing` integer
      - `human_resources` integer
      - `sales` integer
      - `finance` integer
      - `consulting` integer
      - `legal` integer
      - `arts_and_design` integer
      - `accounting` integer
      - `business_development` integer
      - `information_technology` integer
      - `education` integer
      - `media_and_commmunication` integer
      - `product_management` integer
      - `entrepreneurship` integer
      - `data_science` integer
      - `administrative` integer
    - `intent_strength` unknown
    - `show_intent` boolean
    - `has_intent_signal_account` boolean
    - `intent_signal_account` unknown
    - `organization_headcount_six_month_growth` number — The percentage change in the company's total headcount over the previous 6 months. Returns `null` when growth data is not available for the company.
    - `organization_headcount_twelve_month_growth` number — The percentage change in the company's total headcount over the previous 12 months. Returns `null` when growth data is not available for the company.
    - `organization_headcount_twenty_four_month_growth` number — The percentage change in the company's total headcount over the previous 24 months. Returns `null` when growth data is not available for the company.

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403
- `422` — 422
- `429` — 429

---

[API](https://skmtc.dev/apollo/apis/apollo-rest-api.md) · [All operations](https://skmtc.dev/apollo/apis/apollo-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apollo/apollo-rest-api/revisions/c715a05fa6e2/schema)