Sign in
latestOpenAPI 3.0.32026-08-101461131.1 MB

ad6f143e43aa

reference:sec:filings

SEC Filings

List filings

get/v1/reference/sec/filings

Query parameters

type'10-K' | '10-Q'

Filing Type

Query by filing type.

filing_datestring

The date when the filing was filed in YYYYMMDD format.

Example:20210101

Query by filing date.

period_of_report_datestring

The period of report for the filing in YYYYMMDD format.

Example:20210101

Query by period of report.

has_xbrlboolean nullable

If true, query only for filings with an XBRL instance file. If false, query for filings without an XBRL instance file. If this parameter is not provided, query for filings with or without XBRL instance files.

entities.company_data.namestring
Example:Facebook Inc

Query by entity company name.

entities.company_data.cikstring

Central Index Key (CIK) Number

Query by entity company CIK.

entities.company_data.tickerstring

Ticker

Query by entity company ticker.

entities.company_data.sicstring

Standard Industrial Classification (SIC)

Query by entity company SIC.

filing_date.gtestring

The date when the filing was filed in YYYYMMDD format.

Example:20210101

Search by filing_date.

filing_date.gtstring

The date when the filing was filed in YYYYMMDD format.

Example:20210101

Search by filing_date.

filing_date.ltestring

The date when the filing was filed in YYYYMMDD format.

Example:20210101

Search by filing_date.

filing_date.ltstring

The date when the filing was filed in YYYYMMDD format.

Example:20210101

Search by filing_date.

period_of_report_date.gtestring

The period of report for the filing in YYYYMMDD format.

Example:20210101

Search by period_of_report_date.

period_of_report_date.gtstring

The period of report for the filing in YYYYMMDD format.

Example:20210101

Search by period_of_report_date.

period_of_report_date.ltestring

The period of report for the filing in YYYYMMDD format.

Example:20210101

Search by period_of_report_date.

period_of_report_date.ltstring

The period of report for the filing in YYYYMMDD format.

Example:20210101

Search by period_of_report_date.

entities.company_data.name.searchstring

Search by entities.company_data.name.

order'asc' | 'desc'
Example:asc

Order results based on the sort field.

limitinteger
Example:10

Limit the number of results returned, default is 10 and max is 1000.

sort'filing_date' | 'period_of_report_date'
Example:filing_date

Sort field used for ordering.

Response

FIXME

countinteger required
next_urlstring
request_idstring required
statusstring required

Example response

{
  "results": [
    {
      "entities": [
        {
          "company_data": {
            "name": "Facebook Inc"
          }
        }
      ],
      "filing_date": "20210101",
      "period_of_report_date": "20210101",
      "source_url": "https://www.sec.gov/Archives/edgar/data/0001326801/000132680119000037/0001326801-19-000037-index.html"
    }
  ]
}