Query SEC filing metadata
Retrieves metadata for SEC filings based on various filter criteria with pagination and sorting support.
Available Sort Fields
| Field Name | Description |
|---|---|
| AccessionNumber | SEC filing accession number |
| FilingDate | Date when filing was submitted |
| AcceptanceDateTime | Date and time of filing acceptance |
| ReportDate | Date of the report |
| Size | Size of the filing document |
Date Format
All dates must be provided in YYYY-MM-DD format
Form Types
Form types can be provided as comma-separated values, e.g.: "10-K,8-K,10-Q"
Pagination
Results are always paginated. When page_size or page_number are omitted, defaults apply
(page_size: 50, page_number: 1). Maximum page_size is 200. Use page_number to fetch additional pages.
For optimal performance, use date ranges and form types to narrow down your search
API Key is required to access the endpoints
In: header
Query Parameters
Filter by Central Index Key (CIK)
int64Filter by stock ticker symbol
Filter by form type(s) (e.g., "10-K", "8-K"). Multiple values can be comma-separated
Filter by filling date start (inclusive), format YYYY-MM-DD
^\d{4}-\d{2}-\d{2}$Filter by filling date end (inclusive), format YYYY-MM-DD
^\d{4}-\d{2}-\d{2}$Filter by report date start (inclusive), format YYYY-MM-DD
^\d{4}-\d{2}-\d{2}$Filter by report date end (inclusive), format YYYY-MM-DD
^\d{4}-\d{2}-\d{2}$Filter filings where the 'Items' field contains the specified text
Number of results per page (default: 50, max: 200). Always applied; omit to use defaults.
int321 <= value <= 200Page number to retrieve (default: 1). Always applied; omit to use defaults.
int321 <= value <= 2147483647Field to sort results by (default: AccessionNumber)
Value in
- "AccessionNumber"
- "FilingDate"
- "ReportDate"
- "AcceptanceDateTime"
- "Size"
Sort order (asc or desc, default: desc)
^(asc|desc)$"desc"Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/filings"{ "cik": 1234567890, "accession_number": "0001140361-21-012345", "filing_date": "2021-03-15", "report_date": "2020-12-31", "acceptance_date_time": "2021-03-15T16:30:00.0000000Z", "act": "34", "form": "10-K", "file_number": "001-12345", "film_number": "21654321", "items": "1,1A,2", "core_type": "10-K", "size": 15000000, "is_xbrl": true, "is_inline_xbrl": true, "primary_document": "form10k.htm", "primary_doc_description": "Form 10-K Annual Report", "source_file": "edgar/data/1234567890/0001140361-21-012345.txt"}