SEC EDGAR API endpoint
Returns a company's recent SEC filings (form, dates, primary document URL) filtered by form type and date range, plus company profile fields as reported by EDGAR: entity_type, former_names, exchanges, category, fiscal_year_end, state_of_incorporation. Provide cik or ticker.
/sec/company/submissionsReturns a company's recent SEC EDGAR filings with fields and the primary document URL, filtered by form type and date range. Official SEC data.
Query parameters:
cik or ticker (one required) — company identifier.form (optional) — filter by form type, e.g. 10-K, 10-Q, 8-K.from, to (optional) — filing-date bounds (YYYY-MM-DD).limit (optional, default 50, max 500).Response includes company profile (cik, name, former_names, entity_type, tickers, exchanges, sic, sic_description, category, fiscal_year_end, state_of_incorporation) and filings[]: accession_number, form, filing_date, report_date, primary_document, primary_doc_url, items, is_xbrl, filing_index_url.
| Field | Filled in, of 20 checked | Values in the sample |
|---|---|---|
| accession_number | 20 | “0000320193-25-000079” and 19 other values |
| form | 20 | 10-K in all 20 |
| filing_date | 20 | 2006-12-29 to 2025-10-31 |
| report_date | 20 | 2006-09-30 to 2025-09-27 |
| primary_document | 20 | “aapl-20250927.htm” and 17 other values |
| primary_doc_url | 20 | sec.gov |
| description | 20 | 10-K (12), FORM 10-K (5), FOR THE FISCAL YEAR ENDED SEPTE… (1) and 2 more |
| size | 20 | 1,178,091 to 14,071,062, median 9,859,755 |
| is_xbrl | 17 | true in 17 of 17 |
| filing_index_url | 20 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| cik | string | No | SEC CIK (numeric or zero-padded) | 320193 | |
| ticker | string | No | Ticker symbol (alternative to cik) | AAPL | |
| form | string | No | Filter by form type, e.g. 10-K, 10-Q, 8-K | 10-K | |
| from | string | No | Earliest filing date (YYYY-MM-DD) | ||
| to | string | No | Latest filing date (YYYY-MM-DD) | ||
| limit | integer | No | Max filings, default 50, max 500 | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/sec/company/submissions?limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"cik": 320193,
"cik_padded": "CIK0000320193",
"name": "Apple Inc.",
"tickers": [
"AAPL"
],
"sic": "3571",
"sic_description": "Electronic Computers",
"count": 1,
"filings": [
{
"accession_number": "0000320193-25-000079",
"form": "10-K",
"filing_date": "2025-10-31",
"report_date": "2025-09-27",
"primary_document": "aapl-20250927.htm",
"primary_doc_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm",
"is_xbrl": true
}
],
"source_url": "https://data.sec.gov/submissions/CIK0000320193.json"
}
}Request schema
No body schema
Response schema
#/definitions/sec.submissionsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | sec.SubmissionsResponse | No | ||||
| data.category | string | No | Large accelerated filer | SEC filer category, such as `Large accelerated filer`. | ||
| data.cik | integer | No | 320193 | Company's SEC Central Index Key (CIK) number. | ||
| data.cik_padded | string | No | CIK0000320193 | CIK number padded to 10 digits with a `CIK` prefix, as used in SEC data URLs. | ||
| data.count | integer | No | Number of filings returned. | |||
| data.entity_type | string | No | operating | Type of filer, such as `operating`. | ||
| data.exchanges | array | No | Nasdaq | Stock exchanges the company is listed on, such as `Nasdaq`. | ||
| data.filings | array | No | Company's filings, newest first, after applying the form and date filters. | |||
| data.filings[].accession_number | string | No | 0000320193-25-000081 | SEC accession number that uniquely identifies the filing. | ||
| data.filings[].description | string | No | Short description of the main document, as EDGAR lists it. | |||
| data.filings[].filing_date | string | No | 2025-10-31 | Date the filing was submitted to the SEC, in YYYY-MM-DD format. | ||
| data.filings[].filing_index_url | string | No | Link to the filing's index page on sec.gov. | |||
| data.filings[].form | string | No | 10-K | SEC form type of the filing, such as `10-K`, `10-Q` or `8-K`. | ||
| data.filings[].is_xbrl | boolean | No | Whether the filing includes XBRL financial data. | |||
| data.filings[].items | string | No | Item numbers the filing covers, as EDGAR lists them. | |||
| data.filings[].primary_doc_url | string | No | Link to the filing's main document on sec.gov. | |||
| data.filings[].primary_document | string | No | File name of the filing's main document. | |||
| data.filings[].report_date | string | No | 2025-09-27 | Period end date the filing reports on, in YYYY-MM-DD format. | ||
| data.filings[].size | integer | No | Size of the filing's main document as EDGAR reports it. | |||
| data.fiscal_year_end | string | No | 0930 | Last day of the company's fiscal year in MMDD format, such as `0930`. | ||
| data.former_names | array | No | Names the company has previously filed under. | |||
| data.name | string | No | Apple Inc. | Company name as registered with the SEC. | ||
| data.sic | string | No | Standard Industrial Classification (SIC) code of the company. | |||
| data.sic_description | string | No | Text description of the SIC industry code. | |||
| data.source_url | string | No | URL the data was read from. | |||
| data.state_of_incorporation | string | No | CA | Code of the state or country where the company is incorporated. | ||
| data.tickers | array | No | Ticker symbols the company trades under. | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/sec/company/submissions?limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"