--- title: "SEC EDGAR Company" method: POST path: "/us/sec/company/v1" tags: ["United States", "SEC EDGAR"] --- # SEC EDGAR Company `POST /us/sec/company/v1` ## Request - Base URL: `https://api.croma.run` - URL: `https://api.croma.run/us/sec/company/v1` - Auth: HTTP bearer Resolve one EDGAR filer by its CIK and return its record (name and former names, EIN, SIC code, state of incorporation, addresses, phone, tickers and exchanges, filing counts) with its latest event filings since 2020: 8-K current reports, mergers, delistings, registrations, late-filing notices and 13D stakes. `found: false` when EDGAR has no filer under that CIK. Served by Croma (`as_of` says how current the data is), brought up to date daily. **Dataset endpoint**: answers from the whole source in milliseconds and carries `as_of`. ## Headers - `Idempotency-Key` string ## Request body - object - `cik` string, required: CIK del filer en EDGAR, con o sin ceros a la izquierda, p. ej. `320193`. ## Response `200` Successful response - SecCompanyResponse - `data` SecCompanyData, required - `found` boolean, required - `cik` string, required - `as_of` string, nullable, required: How current the data in this response is. - `company` object, nullable, required - `cik` string, required: EDGAR's Central Index Key, without leading zeros: `320193` is Apple. - `name` string, nullable, required: The filer's name as EDGAR holds it today; null for the few filers EDGAR holds without one. - `entity_type` string, nullable, required: `operating` (a company that files periodic reports), `investment` (a registered fund), or `other`: persons, trusts, funds and companies that file other forms. - `sic` string, nullable, required: The Standard Industrial Classification code EDGAR assigns, e.g. `3571`. - `sic_description` string, nullable, required - `owner_org` string, nullable, required: The SEC office that reviews the filer, e.g. `06 Technology`. - `insider_transactions_as_owner` boolean, required: The filer has reported insider transactions as an owner (Forms 3, 4, 5). - `insider_transactions_as_issuer` boolean, required: Insiders have reported transactions in the filer's own securities. - `tickers` string[], required: The filer's tickers, when it is listed. - `exchanges` string[], required: Where those tickers trade: `NYSE`, `Nasdaq`, `OTC`, `CBOE`. - `ein` string, nullable, required: The IRS Employer Identification Number, nine digits, as the filer gave it to EDGAR. Null when EDGAR has none (it holds `000000000` for many filers, which is served as null). - `lei` string, nullable, required: The Legal Entity Identifier, rarely given. - `description` string, nullable, required - `website` string, nullable, required - `investor_website` string, nullable, required - `filer_categories` string[], required: The filer status EDGAR records: `Large accelerated filer`, `Smaller reporting company`, `Emerging growth company`, ... - `fiscal_year_end` string, nullable, required: `MMDD` the filer's fiscal year ends, e.g. `1231`. - `state_of_incorporation` string, nullable, required: EDGAR's code for the state or country of incorporation: `DE`, `NV`, `E9` (Cayman Islands), ... - `state_of_incorporation_description` string, nullable, required - `business_address` object, required - `street_1` string, nullable, required - `street_2` string, nullable, required - `city` string, nullable, required - `state_or_country` string, nullable, required: EDGAR's code for the state or country of the business address. - `state_or_country_description` string, nullable, required: What the code stands for, as EDGAR spells it. - `zip_code` string, nullable, required - `is_foreign_location` boolean, nullable, required - `foreign_state_territory` string, nullable, required - `country` string, nullable, required - `country_code` string, nullable, required - `mailing_address` object, required - `street_1` string, nullable, required - `street_2` string, nullable, required - `city` string, nullable, required - `state_or_country` string, nullable, required: EDGAR's code: a two-letter US state, or a code for a country or province (`E9` is the Cayman Islands, `A6` Ontario). - `state_or_country_description` string, nullable, required: What the code stands for, as EDGAR spells it. - `zip_code` string, nullable, required - `is_foreign_location` boolean, nullable, required - `foreign_state_territory` string, nullable, required - `country` string, nullable, required - `country_code` string, nullable, required - `phone` string, nullable, required - `flags` string, nullable, required: What EDGAR flags on the filer, e.g. `REVOKED` when the SEC revoked its registration. - `former_names` string[], required: Every name the filer used before, for search. - `name_history` object[], required: The former names with the dates each was in use. - `name` string, required - `from` string, nullable, required: `yyyy-mm-dd` the name was first used on EDGAR. - `to` string, nullable, required: `yyyy-mm-dd` the name was last used. - `filing_count` integer, required: Filings of every form EDGAR lists for the filer. - `first_filed_on` string, nullable, required: `yyyy-mm-dd` of the filer's first filing on EDGAR. - `last_filed_on` string, nullable, required: `yyyy-mm-dd` of its latest filing. - `edgar_url` string, required: The filer's page on EDGAR. - `updated_at` string, required: When this record was last brought up to date from EDGAR. - `filing_events` object[], required: The filer's latest event filings since 2020, newest first, up to 20. - `id` string, required: `:`: the filing, for one of its filers. - `accession_number` string, required: EDGAR's accession number of the filing, e.g. `0001193125-26-012345`. - `cik` string, required: The filer this row is for, without leading zeros. - `form` string, required: The form type exactly as EDGAR spells it: `8-K`, `8-K/A`, `S-4`, `425`, `25-NSE`, `15-12B`, `SC 13D`, `SCHEDULE 13D`, `NT 10-K`, ... - `event_type` 'current_report' | 'merger_or_acquisition' | 'delisting_or_deregistration' | 'registration' | 'late_filing_notice' | 'beneficial_ownership', required: What kind of event the form is. - `filed_on` string, required: `yyyy-mm-dd`, the filing's official date. - `report_date` string, nullable, required: `yyyy-mm-dd` of the event reported, when the form gives one. - `accepted_at` string, nullable, required: When EDGAR accepted the filing. - `act` string, nullable, required: The securities act the filing is under, e.g. `34`, `33`. - `file_number` string, nullable, required: The SEC file number the filing is under for this filer, e.g. `001-36743`. - `film_number` string, nullable, required - `items` string[], required: For an 8-K, the items reported: `1.01` material agreement, `1.03` bankruptcy, `2.01` acquisition completed, `2.02` results, `3.01` delisting notice, `5.02` officer or director change, `9.01` exhibits, ... - `core_type` string, nullable, required - `size` integer, nullable, required: The filing's size in bytes. - `is_xbrl` boolean, required - `is_inline_xbrl` boolean, required - `primary_document` string, nullable, required: The file name of the filing's main document. - `primary_document_description` string, nullable, required - `filing_url` string, required: The filing's index page on EDGAR. - `source_document_url` string, nullable, required: The filing's main document on EDGAR. - `filing_events_total` number, required: Every event filing of the filer since 2020. ## Other responses - `400`: Invalid request body - `401`: Missing or invalid API key - `429`: Rate limit exceeded - `500`: Internal error - `502`: Upstream source returned an error --- [API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)