# Firmographics

Returns detailed information about the specified companies, including firmographics, installed technologies, and more.

Results are internally sorted by revenue (descending).

It's also possible to specify what fields from the API should be returned. By default, only some fields are returned.

Endpoint: POST /data-api/v1/company/firmographics
Security: authorization

## Request fields (application/json):

  - `company_ids` (array, required)
    Array of company IDs to retrieve
    Example: ["1698C53EBC888758570396E0334965C1"]

  - `fields` (array)
    A list of data points to be returned in the API response.
    Enum: "company_id", "company_name", "domain_name", "domain_name_normalized", "company_level", "city_name", "state_name", "postal_code", "country_name", "country_code", "continent_name", "subcontinent_name", "geopolitical_name", "industry_id", "industry_name", "naics_code", "naics_name", "sic_codes", "sic_names", "revenue_total", "revenue_band", "employees_total", "employees_band", "it_spend", "forbes_2000_rank", "fortune_500_rank", "global_hq_company_name", "global_hq_domain_name", "global_hq_domain_name_normalized", "global_hq_hg_id", "global_hq_city_name", "global_hq_state_name", "global_hq_postal_code", "global_hq_country_name", "global_hq_country_code", "global_hq_subcontinent_name", "global_hq_continent_name", "global_hq_geopolitical_name", "global_hq_employees_band", "global_hq_revenue_band", "global_hq_industry_id", "global_hq_industry_name", "global_hq_naics_code", "global_hq_naics_name", "global_hq_sic_codes", "global_hq_sic_names", "global_hq_forbes_2000_rank", "global_hq_fortune_500_rank"

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

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

## Response 200 fields (application/json):

  - `count` (integer)
    The number of companies returned.

  - `data` (array)

  - `data.company_name` (string)

  - `data.domain_name` (string)

  - `data.domain_name_normalized` (string)

  - `data.hg_id` (string)

  - `data.naics_name` (string)

  - `data.global_hq_sic_codes` (array)

  - `data.global_hq_country_code` (string)

  - `data.naics_code` (string)

  - `data.revenue_total` (integer,null)
    Revenue in USD

  - `data.fortune_500_rank` (integer,null)

  - `data.global_hq_country_name` (string)

  - `data.global_hq_industry_name` (string)

  - `data.global_hq_city_name` (string)

  - `data.subcontinent_name` (string)

  - `data.state_name` (string)

  - `data.company_level` (string)

  - `data.country_code` (string)

  - `data.global_hq_continent_name` (string)

  - `data.global_hq_domain_name` (string)

  - `data.employees_band` (string)
    Employees band

  - `data.global_hq_employees_band` (string)

  - `data.global_hq_revenue_band` (string)

  - `data.sic_codes` (array)

  - `data.global_hq_state_name` (string)

  - `data.industry_id` (integer)

  - `data.global_hq_fortune_500_rank` (integer,null)

  - `data.industry_name` (string)

  - `data.global_hq_naics_name` (string)

  - `data.postal_code` (string)

  - `data.global_hq_geopolitical_name` (string)

  - `data.employees_total` (integer,null)
    Number of employees

  - `data.geopolitical_name` (string)

  - `data.global_hq_hg_id` (string)

  - `data.global_hq_industry_id` (integer)

  - `data.global_hq_subcontinent_name` (string)

  - `data.revenue_band` (string)
    Revenue band

  - `data.country_name` (string)

  - `data.forbes_2000_rank` (integer,null)

  - `data.global_hq_domain_name_normalized` (string)

  - `data.it_spend` (integer,null)

  - `data.global_hq_sic_names` (array)

  - `data.global_hq_forbes_2000_rank` (integer,null)

  - `data.global_hq_company_name` (string)

  - `data.continent_name` (string)

  - `data.sic_names` (array)

  - `data.global_hq_naics_code` (string)

  - `data.global_hq_postal_code` (integer)

  - `data.city_name` (string)

## Response 401 fields (application/json):

  - `errors` (array)

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

  - `errors.source` (object)

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

## Response 404 fields (application/json):

  - `errors` (array)

  - `errors.detail` (string, required)

  - `errors.source` (object)

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

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