Qualify Company
qualify_companyCheck if a company is publicly listed using identifiers like ticker, domain, or CIK. Filter to keep only listed companies or exclude them to target private businesses.
Instructions
Answer whether a company is publicly listed. Takes the same identifiers as resolve_company and returns a listed status verdict per input. Set listed_only to keep only the companies proven to be listed, or suppress_listed to remove them, which is what you want when selling only into private companies. By default an unmatched company returns is_listed null rather than false, because a non match may mean the company is private OR that the dataset does not hold its domain; set assume_unmatched_is_private to true to opt into reading a non match as private. Charged per company row returned. Requires an APIFY_TOKEN and consumes Apify credits. Read only.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ciks | No | SEC Central Index Keys, with or without leading zeros. | |
| leis | No | 20 character Legal Entity Identifiers. | |
| isins | No | 12 character ISINs. | |
| regions | No | Shorthand for a set of venues and countries: us, uk, eu. Widens an explicit exchange or country filter rather than replacing it. | |
| sectors | No | SEC SIC descriptions, e.g. Pharmaceutical Preparations. Populated on roughly 65 percent of the publishable universe. | |
| tickers | No | Exchange tickers, e.g. NWLG. Matched against the primary ticker and every venue listing. | |
| cadences | No | quarterly, semiannual, annual, unknown. | |
| listed_only | No | qualify mode. Keep only rows proven to be publicly listed. | |
| company_names | No | Legal or trading names. Matched on a normalized name. Former names are not available: the alias table carries tickers and ISINs only. | |
| country_codes | No | ISO 3166-1 alpha-2, e.g. US, GB, FR. | |
| company_domain | No | A single bare domain, e.g. stripe.com. The Clay column shape. Used by resolve, qualify and timing. | |
| exchange_codes | No | ISO 10383 MICs. 18 venues are covered. | |
| security_types | No | ordinary_shares, depositary_receipt, preferred_shares. | |
| company_domains | No | Many domains at once. Used by resolve, qualify and timing. | |
| suppress_listed | No | qualify mode. Remove companies proven to be publicly listed, for anyone selling only into private companies. It removes what we can prove is listed; it does not warrant that the remainder is private. | |
| public_float_bands | No | micro, small, mid, large, mega, unknown. Size runs on public float because market capitalization is not populated anywhere in this dataset. | |
| us_registrant_only | No | Keep only companies carrying an SEC CIK. | |
| exclude_share_alike | No | Drop rows derived from CC BY-SA sources, whose share alike condition may not suit a closed product. | |
| exclude_blank_checks | No | Drop pre deal SPACs. Separate from the operating company filter: a blank check shell is flagged as an operating company and passes every ordinary firmographic filter. | |
| fiscal_year_end_months | No | Integers 1 to 12. Fiscal year end is effectively a United States field in this dataset. | |
| foreign_private_issuer | No | Filter on foreign private issuer status. | |
| operating_companies_only | No | Drop funds, trusts and other non operating entities. Sent as a string for Clay compatibility. | |
| exclude_name_only_matches | No | Drop rows whose identity link rests on a name and country agreeing rather than on an identifier. Use this wherever a wrong identity link matters. | |
| min_provenance_confidence | No | Set to high to exclude rows whose source terms were never read. | |
| assume_unmatched_is_private | No | qualify mode. By default an unmatched company returns is_listed null, because a non match may mean the company is private OR that we do not hold its domain. Set true to opt into reading a non match as private, which sets is_listed false. | |
| exclude_december_fiscal_year_end | No | Keep only companies whose fiscal year ends in a month other than December, the accounts whose budget cycle is out of phase with a calendar quarter. |