# Enrich Companies

Unified endpoint to enrich company data with firmographics, spend, and technographics.

Select which data categories to include using the fields parameter. By default, all categories are included.
Filter technographics by categories, vendors, or products using the filters parameter.
Control pagination for both companies and nested technographics data.

Endpoint: POST /data-api/v2/companies/enrich
Security: authorization

## Request fields (application/json):

  - `companies` (object, required)
    Filter companies by IDs
    Example: {"ids":["78040737422146204640576327630924184547","1698C53EBC888758570396E0334965C1"]}

  - `companies.ids` (array, required)
    Array of hex-encoded company IDs
    Example: ["78040737422146204640576327630924184547","1698C53EBC888758570396E0334965C1"]

  - `fields` (array)
    Which data categories to include in the response
    Enum: "firmographics", "spend", "technographics"

  - `filters` (object)
    Filters for enrich request

  - `filters.technographics` (object)
    Filters for technographics data
    Example: {"product_categories":{"ids":["319D067B229178F03BCFA1DA4AC4DEDE"]},"products":{"ids":[814]},"vendors":{"ids":[316]}}

  - `filters.technographics.product_categories` (object)
    Filter by hex-encoded IDs (assumes ANY_PRESENT inclusion method)

  - `filters.technographics.product_categories.ids` (array)
    Array of hex-encoded IDs
    Example: ["1698C53EBC888758570396E0334965C1"]

  - `filters.technographics.products` (object)
    Filter by numeric IDs (assumes ANY_PRESENT inclusion method)

  - `filters.technographics.products.ids` (array)
    Array of numeric IDs

  - `filters.technographics.vendors` (object)
    Filter by numeric IDs (assumes ANY_PRESENT inclusion method)

  - `pagination` (object)
    Pagination parameters for companies and nested data

  - `pagination.spend` (object)
    Common pagination parameters

  - `pagination.spend.limit` (integer)
    The number of records to return in the request.

  - `pagination.spend.offset` (integer)
    Used for paginating records.

  - `pagination.technographics` (object)
    Common pagination parameters

## Response 200 fields (application/json):

  - `companies` (array)
    Example: [{"company_id":"78040737422146204640576327630924184547","firmographics":{"company_name":"Example Corp","country_code":"US","domain_name":"example.com","hg_id":"78040737422146204640576327630924184547"},"spend":{"all":[{"absolute_spend":125000,"category_id":"319D067B229178F03BCFA1DA4AC4DEDE","category_name":"Software","country_code":"US"}],"all_count":1},"technographics":{"installs":[{"country_code":"US","product_id":814,"product_intensity":5,"product_last_verified_date":"2024-05-20","product_name":"Java","vendor_name":"Oracle"}],"installs_count":1}}]

  - `companies.company_id` (string)
    Unique hexadecimal identifier
    Example: "1698C53EBC888758570396E0334965C1"

  - `companies.firmographics` (any)
    Firmographic data for a company

  - `companies.spend` (object)
    Spend data
    Example: {"all":[{"absolute_spend":125000,"category_id":"319D067B229178F03BCFA1DA4AC4DEDE","category_name":"Software","country_code":"US"}],"all_count":1}

  - `companies.spend.all` (array)
    Array of spend records
    Example: [{"absolute_spend":125000,"category_id":"319D067B229178F03BCFA1DA4AC4DEDE","category_name":"Software","country_code":"US"}]

  - `companies.spend.all_count` (integer)
    Total count of spend records
    Example: 1

  - `companies.technographics` (object)
    Technographics data
    Example: {"installs":[{"country_code":"US","product_id":814,"product_intensity":5,"product_last_verified_date":"2024-05-20","product_name":"Java","vendor_name":"Oracle"}],"installs_count":1}

  - `companies.technographics.installs` (array)
    Array of technology installs
    Example: [{"country_code":"US","product_id":814,"product_intensity":5,"product_last_verified_date":"2024-05-20","product_name":"Java","vendor_name":"Oracle"}]

  - `companies.technographics.installs_count` (integer)
    Total count of installs
    Example: 1

## Response 401 fields (application/json):

  - `errors` (array)

  - `errors.detail` (string, required)
    Example: "The token provided is not valid"

  - `errors.source` (null)

  - `errors.title` (string, required)
    Example: "Unauthorized"

## Response 422 fields (application/json):

  - `errors` (array, required)

  - `errors.detail` (string, required)
    Example: "null value where string expected"

  - `errors.source` (object, required)

  - `errors.source.pointer` (string, required)
    Example: "/data/attributes/petName"

  - `errors.title` (string, required)
    Example: "Invalid value"