Datasets API endpoint
Returns one SEC-reporting company by CIK from dataset id `sec-companies`, including its filing-history summary, financial-statement rollups, and trailing-90-day insider-activity summary. Returns 404 when the CIK is not in the dataset.
/datasets/sec-companies/items/{cik}Path parameters:
cik: required. SEC CIK, numeric or zero-padded, e.g. 320193 or 0000320193.Response behavior:
404 when the CIK is not in the dataset (not yet backfilled, or never a reporting company in scope — see the dataset's seed-population notes).search endpoint's items[] entries.GET /sec/company/submissions instead.| Field | Filled in, of 50 checked | Values in the sample |
|---|---|---|
| accession_number | 50 | |
| form | 50 | |
| filing_date | 50 | 2026-04-02 to 2026-10-08 |
| primary_doc_url | 50 | sec.gov |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| cik (path) | string | Yes | SEC CIK, numeric or zero-padded, e.g. 320193 or 0000320193 | 320193 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/datasets/sec-companies/items/320193" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"cik": 320193,
"cik_padded": "0000320193",
"name": "Apple Inc.",
"former_names": [
"Apple Computer Inc."
],
"tickers": [
"AAPL"
],
"primary_ticker": "AAPL",
"exchange": [
"Nasdaq"
],
"sic": "3571",
"sic_description": "Electronic Computers",
"state_of_incorporation": "CA",
"fiscal_year_end": "0928",
"entity_type": "operating",
"filing_count": 342,
"latest_filing_date": "2025-10-31",
"forms_filed": [
"10-K",
"10-Q",
"8-K",
"4"
],
"recent_filings": [
{
"accession_number": "0000320193-25-000081",
"form": "10-K",
"filing_date": "2025-10-31",
"primary_doc_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000081/aapl-20250927.htm"
}
],
"latest_annual_fiscal_year": 2024,
"latest_annual_revenue": 391035000000,
"latest_annual_net_income": 93736000000,
"latest_annual_total_assets": 364980000000,
"revenue_band": "over_10b",
"insider_txn_count_90d": 6,
"insider_net_shares_90d": -18000,
"insider_last_transaction_at": "2025-11-15",
"crawled_at": "2026-07-15T03:12:00Z"
}
}Request schema
No body schema
Response schema
#/definitions/datasets.secCompaniesItemResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | es.SecCompanyRecord | No | ||||
| data.cik | integer | No | SEC Central Index Key of the company. Use it with the company item endpoint. | |||
| data.cik_padded | string | No | CIK zero-padded to 10 digits, usually with a `CIK` prefix, such as `CIK0000320193`. | |||
| data.crawled_at | string | No | Time the company record was last collected, in UTC (RFC 3339). | |||
| data.entity_type | string | No | Entity type EDGAR reports for the filer, such as `operating`. | |||
| data.exchange | array | No | Stock exchanges the company is listed on, as EDGAR reports them, such as `Nasdaq` or `NYSE`. | |||
| data.filing_count | integer | No | Number of filings the company has on EDGAR. | |||
| data.financials_synced_at | string | No | Time the financial figures were last updated, in UTC (RFC 3339). | |||
| data.fiscal_year_end | string | No | Last day of the company's fiscal year as month and day (MMDD), for example `0928`. | |||
| data.former_names | array | No | Names the company filed under previously. | |||
| data.forms_filed | array | No | Distinct SEC form types the company has filed. | |||
| data.insider_last_transaction_at | string | No | Date of the most recent insider transaction in the last 90 days. | |||
| data.insider_net_shares_90d | number | No | Shares insiders acquired minus shares they disposed of over the last 90 days. Negative when more were sold. | |||
| data.insider_txn_count_90d | integer | No | Number of insider transactions reported over the last 90 days. | |||
| data.latest_annual_fiscal_year | integer | No | Fiscal year of the latest annual financial figures. | |||
| data.latest_annual_net_income | number | No | Net income for the latest fiscal year, in the filer's reporting currency. | |||
| data.latest_annual_net_income_usd | number | No | Net income for the latest fiscal year, converted to US dollars at a fixed reference rate. | |||
| data.latest_annual_revenue | number | No | Revenue for the latest fiscal year, in the filer's reporting currency. | |||
| data.latest_annual_revenue_usd | number | No | Revenue for the latest fiscal year, converted to US dollars at a fixed reference rate. | |||
| data.latest_annual_total_assets | number | No | Total assets at the end of the latest fiscal year, in the filer's reporting currency. | |||
| data.latest_annual_total_assets_usd | number | No | Total assets at the end of the latest fiscal year, converted to US dollars at a fixed reference rate. | |||
| data.latest_filing_date | string | No | Date of the company's most recent filing, in YYYY-MM-DD format. | |||
| data.latest_quarterly_fiscal_year | integer | No | Fiscal year of the latest quarterly financial figures. | |||
| data.latest_quarterly_revenue | number | No | Revenue for the latest reported quarter, in the filer's reporting currency. | |||
| data.name | string | No | Company name as registered with the SEC. | |||
| data.primary_ticker | string | No | Main stock ticker symbol of the company. | |||
| data.recent_filings | array | No | Most recent filings of the company, newest first. | |||
| data.recent_filings[].accession_number | string | No | SEC accession number that uniquely identifies the filing. | |||
| data.recent_filings[].filing_date | string | No | Date the filing was submitted to the SEC, in YYYY-MM-DD format. | |||
| data.recent_filings[].form | string | No | SEC form type of the filing, such as `10-K`, `10-Q` or `8-K`. | |||
| data.recent_filings[].primary_doc_url | string | No | URL of the filing's main document on SEC.gov. | |||
| data.reporting_currency | string | No | Native-currency figures are exactly as the filer reported them (see ReportingCurrency); the *USD fields are the same values converted at fixed reference rates so they can be sorted, banded and range-filtered ACROSS currencies. Screen on the USD fields; display the native value + currency. | |||
| data.revenue_band | string | No | Size band of the latest annual revenue in US dollars: `under_1m`, `1m_10m`, `10m_100m`, `100m_1b`, `1b_10b`, `over_10b` or `unknown`. | |||
| data.schema_version | integer | No | Version of the record format. | |||
| data.seed_source | string | No | Label of the SEC company list this record was first built from. | |||
| data.sic | string | No | Standard Industrial Classification code of the company. | |||
| data.sic_description | string | No | Plain-text description of the company's SIC code. | |||
| data.state_of_incorporation | string | No | Code of the state or country where the company is incorporated. | |||
| data.submissions_synced_at | string | No | Time the filing history was last updated, in UTC (RFC 3339). | |||
| data.tickers | array | No | All stock ticker symbols of the company. | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/datasets/sec-companies/items/320193" \
-H "x-api-key: $CRAWLORA_API_KEY"