Company Request Parameters

Detailed reference for all supported Company - Look up request parameters, including property descriptions, data types, and usage guidelines.

Property	Type	Description
`filter`		- Add filters to your company query.
`filter.company_id`	string	- Filter by life to death unique record identifier. - This is an optional attribute. - This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering. Example: `["1eef06a0-8c6f-4b09-b5a7-b9b7e0d6737b"]`
`filter.acme_id`	string	- Filter by legacy organization ID. - This is an optional attribute. - This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering. Example: `["20"]`
`filter.role`	string	- Filter by hierarchy type - This is an optional attribute. Must be one of: `holding`, `headquarters`, `subsidiary`, `branch`, `standalone`
`filter.address`	string	- Filter by street address for the organization's primary physical address. - This is an optional attribute.
`filter.address_city`	string	- Filter by city of an organization's primary physical address. - This is an optional attribute. Example: `["Moscow"]`
`filter.address_latitude`	float	- Filter by latitude of the organization's primary address. - This is an optional attribute.
`filter.address_longitude`	float	- Filter by longitude of the organization's primary address. - This is an optional attribute.
`filter.address_postalcode`	string	- Filter by postal/zip code of an organization's primary physical address. - This is an optional attribute.
`filter.anzsic`	string	- Filter by Australian and New Zealand Standard Industrial Classification (ANZSIC) 2006 (Revision 2.0), 4-digit code. - This is an optional attribute.
`filter.cik_code`	string	- Filter by Company 10-digit CIK (Central Index Key). - This is an optional attribute.
`filter.company_email`	string	- Filter by company main information email. - This is an optional attribute.
`filter.company_name`	string	- Filter by commonly used or trade style name of organization. - This is an optional attribute. - This value may be an array of values to filter by (inclusively) or an object describing more nuanced filtering. Example: `["Lightcast"]`
`filter.company_name_alternate`	string	- Filter by alternate company name such as different spellings. - This is an optional attribute.
`filter.company_operating_status`	string	- Choose active or inactive. - This is an optional attribute. Must be one of: `active`, `inactive`
`filter.company_phone`	string	- Filter by organization's primary phone number. - This is an optional attribute.
`filter.cusip`	string	- Filter by company 9-character alphanumeric identifier for financial securities (stocks, bonds, etc.) in the U.S. and Canada. - This is an optional attribute. Example: `["A"]`
`filter.domain`	string	- Filter by domain of the organization. - This is an optional attribute. Example: `["lightcast.io"]`
`filter.global_headcount_range`	string	- Filter by range of the organization's total worldwide employees. - This is an optional attribute. Example: `["1-200"]`
`filter.global_revenue_range`	string	- Filter by range of the organization's annual global revenue in U.S. dollars. - This is an optional attribute. Example: `["$0-5M"]`
`filter.holding_id`	string	- Filter by unique identifier of holding parent company. - This is an optional attribute.
`filter.immediate_parent_country`	string	- Filter by country of the immediate parent organization's primary physical location. - This is an optional attribute. Example: `["US"]`
`filter.immediate_parent_id`	string	- Filter by unique identifier of the immediate parent organization. - This is an optional attribute.
`filter.immediate_parent_name`	string	- Filter by name of the immediate parent organization. - This is an optional attribute.
`filter.ipeds_id`	string	- Filter by unique identifier assigned by the US National Center for Education Statistics (NCES). - This is an optional attribute.
`filter.is_brand`	boolean	- Filter by whether company is brand or trademark record of another entity. - This is an optional attribute.
`filter.is_education`	boolean	- Filter by whether the organization is an educational institution. - This is an optional attribute.
`filter.is_exporter`	boolean	- Filter by whether the organization is a goods or service international exporter. - This is an optional attribute.
`filter.is_fortune100`	boolean	- Filter by whether the company is part of the current Fortune 100. - This is an optional attribute.
`filter.is_fortune500`	boolean	- Filter by whether the company is part of the current Fortune 500. - This is an optional attribute.
`filter.is_fortune1000`	boolean	- Filter by whether the company is part of the current Fortune 1000. - This is an optional attribute.
`filter.is_franchise`	boolean	- Filter by whether a company belongs to a franchise. - This is an optional attribute.
`filter.is_government`	boolean	- Filter by whether the organization is a government organization - This is an optional attribute.
`filter.is_importer`	boolean	- Filter by whether the organization is a goods or service international importer. - This is an optional attribute.
`filter.is_job_board`	boolean	- Filter by whether the organization is a job board. - This is an optional attribute.
`filter.is_non_profit`	boolean	- Filter by whether the organization is a non-profit entity. - This is an optional attribute.
`filter.is_publicly_traded`	boolean	- Filter by whether the organization is a publicly traded company. - This is an optional attribute.
`filter.is_staffing`	boolean	- Filter by whether the organization is a staffing/recruitment company. - This is an optional attribute.
`filter.laa_admin0_division`	string	- Filter by North American geographic divisions. - This is an optional attribute. Example: `["New England"]`
`filter.laa_admin0_region`	string	- Filter by North American geographic regions. - This is an optional attribute. Example: `["Northeast"]`
`filter.laa_admin_area_1`	string	- Filter by State/Province/Region code of the organization's primary physical address based on the global Lightcast Administrative Area framework. \|- This is an optional attribute. Example: `["US06"]`
`filter.laa_admin_area_1_name`	string	- Filter by State/Province/Region name of the organization's primary physical address based on the global Lightcast Administrative Area framework. - This is an optional attribute. Example: `["California"]`
`filter.laa_admin_area_2`	string	- Filter by Sub-national Level 2 geographic identifier code (e.g., County level in the US) based on the global Lightcast Administrative Area framework. - This is an optional attribute. Example: `["US16057"]`
`filter.laa_admin_area_2_name`	string	- Filter by Sub-national Level 2 geographic identifier name (e.g., County level in the US) based on the global Lightcast Administrative Area framework - This is an optional attribute. Example: `["Latah County, ID"]`
`filter.laa_country`	string	- Filter by 2-digit country code of the organization's primary address based on the global Lightcast Administrative Area framework. - This is an optional attribute. Example: `["US"]`
`filter.laa_country_name`	string	- Filter by country name of the organization's primary address (e.g. United States) based on the global Lightcast Administrative Area framework - This is an optional attribute. Example: `["United States"]`
`filter.laa_metro_code`	string	- Filter by Metropolitan Area code based on the global Lightcast Administrative Area framework - This is an optional attribute. Example: `["US42660"]`
`filter.laa_metro_name`	string	- Filter by Metropolitan Area name based on the global Lightcast Administrative Area framework - This is an optional attribute. Example: `["Seattle-Tacoma-Bellevue, WA"]`
`filter.laa_region_code`	string	- Filter by International ISO 3-digit geographic code for geographic region containing the organization's primary physical address - This is an optional attribute. Example: `["019"]`
`filter.laa_region_name`	string	- Filter by International ISO geographic name (e.g. Europe) for geographic region containing the organization's primary physical address - This is an optional attribute. Example: `["Americas"]`
`filter.laa_subregion_code`	string	- Filter by International ISO geographic subregion codes for geographic region containing the organization's primary physical address - This is an optional attribute. Example: `["021"]`
`filter.laa_subregion_name`	string	- Filter by International ISO geographic name for geographic region containing the organization's primary physical address - This is an optional attribute. Example: `["Northern America"]`
`filter.linkedin_url`	string	- Filter by Organization's LinkedIn profile URL - This is an optional attribute. Example: `["https://www.linkedin.com/company/emsi-international"]`
`filter.nace_rev2`	string	- Filter by Statistical Classification of Economic Activities in the European Community (NACE Rev. 2) code. - This is an optional attribute. Example: `["J63.1.1"]`
`filter.naics_2`	string	- Filter by North American Industry Classification System (NAICS) 2022, 2-digit codecodes. - This is an optional attribute. Example: `["51"]`
`filter.naics_3`	string	- Filter by North American Industry Classification System (NAICS) 2022, 3-digit code - This is an optional attribute. Example: `["518"]`
`filter.naics6`	string	- Filter by Primary North American Industry Classification System (NAICS) 2022, 6-digit code - This is an optional attribute. Example: `["518210"]`
`filter.naics6_2017`	string	- Filter by North American Industry Classification System (NAICS) 2017, 6-digit code - This is an optional attribute. Example: `["518210"]`
`filter.naics6_secondary`	string	- Filter by Secondary North American Industry Classification System (NAICS) 2022, 6-digit code - This is an optional attribute.
`filter.previous_name`	string	- Filter by Previous name of company - This is an optional attribute.
`filter.sic87_4d`	string	- Filter by Standard Industrial Classification (SIC) 1987, 4-digit industry codee) - This is an optional attribute.
`filter.ssic2015`	string	- Filter by Singapore Standard Industrial Classification (SSIC) 2015, 5-digit code - This is an optional attribute.
`filter.ssic2020`	string	- Filter by Singapore Standard Industrial Classification (SSIC) 2020, 5-digit code - This is an optional attribute.
`filter.stock_exchange`	string	- Filter by primary stock exchange on which the organization's shares are traded - This is an optional attribute. Example: `["NYSE"]`
`filter.ticker_symbol`	string	- Filter by organization's primary stock ticker symbol - This is an optional attribute. Example: `["AMZN"]`
`filter.twitter`	string	- Filter by organization's primary X (formerly Twitter) profile URL - This is an optional attribute.
`filter.uk_sic_1`	string	- Filter by UK Standard Industrial Classification (SIC) 2007, 1-digit section code - This is an optional attribute.
`filter.uk_sic_2`	string	- Filter by UK Standard Industrial Classification (SIC) 2007, 2-digit division code - This is an optional attribute.
`filter.uk_sic_5`	string	- Filter by UK Standard Industrial Classification of Economic Activities (SIC) 2007, 5-digit code - This is an optional attribute.
`filter.ultimate_parent_country`	string	- Filter by country of physical location of ultimate parent organization - This is an optional attribute.
`filter.ultimate_parent_id`	string	- Filter by unique ID of ultimate parent record - This is an optional attribute.
`filter.ultimate_parent_name`	string	- Filter by name of ultimate parent organization - This is an optional attribute.
`filter.website`	string	- Filter by organization's primary website URL - This is an optional attribute.
`filter.year_founded`	integer	- Filter by year the organization was founded - This is an optional attribute.