# Firmographic

Returns detailed information about the specified company, 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/firmographic
Security: authorization

## Request fields (application/json):

  - `company_id` (any, required)
    A unique hexadecimal identifier for the desired field.
    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"

## Response 200 fields (application/json):

  - `company_name` (string)

  - `domain_name` (string)

  - `domain_name_normalized` (string)

  - `hg_id` (string)

  - `naics_name` (string)

  - `global_hq_sic_codes` (array)

  - `global_hq_country_code` (string)

  - `naics_code` (string)

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

  - `fortune_500_rank` (integer,null)

  - `global_hq_country_name` (string)

  - `global_hq_industry_name` (string)

  - `global_hq_city_name` (string)

  - `subcontinent_name` (string)

  - `state_name` (string)

  - `company_level` (string)

  - `country_code` (string)

  - `global_hq_continent_name` (string)

  - `global_hq_domain_name` (string)

  - `employees_band` (string)
    Employees band

  - `global_hq_employees_band` (string)

  - `global_hq_revenue_band` (string)

  - `sic_codes` (array)

  - `global_hq_state_name` (string)

  - `industry_id` (integer)

  - `global_hq_fortune_500_rank` (integer,null)

  - `industry_name` (string)

  - `global_hq_naics_name` (string)

  - `postal_code` (string)

  - `global_hq_geopolitical_name` (string)

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

  - `geopolitical_name` (string)

  - `global_hq_hg_id` (string)

  - `global_hq_industry_id` (integer)

  - `global_hq_subcontinent_name` (string)

  - `revenue_band` (string)
    Revenue band

  - `country_name` (string)

  - `forbes_2000_rank` (integer,null)

  - `global_hq_domain_name_normalized` (string)

  - `it_spend` (integer,null)

  - `global_hq_sic_names` (array)

  - `global_hq_forbes_2000_rank` (integer,null)

  - `global_hq_company_name` (string)

  - `continent_name` (string)

  - `sic_names` (array)

  - `global_hq_naics_code` (string)

  - `global_hq_postal_code` (integer)

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