SEC Filings

Filing by accession number

Free Starter Stock ETF Pro

Returns a single SEC filing identified by its accession number. The filing must be within your subscription tier's historical data limit.

The documents array contains slide/exhibit image filenames (JPG, PNG, GIF, PDF) extracted from the filing. To build a document URL, replace the filename at the end of the filing url with the document filename.

get/api/filings/search-by-accession-number

Query parameters

accessionNumberstring required

The SEC accession number (e.g. 0000320193-23-000106)

Response

The SEC filing

typestring required

SEC form type

accessionNumberstring required

SEC accession number

urlstring required

URL to the filing document

dateFiledstring required

Date the filing was submitted to the SEC (YYYY-MM-DD)

xbrlboolean required

Whether the filing includes XBRL data

amendmentboolean required

Whether this filing is an amendment

periodEndDatestring

Period end date for the report (YYYY-MM-DD). Omitted for filings without a reporting period (Form 144, 4, etc).

documentsstring[]

Ordered list of slide/exhibit filenames (images >= 50KB). To get the full URL, replace the filename in the filing url with the document filename. Omitted when no extractable documents are present.

titlestring

Descriptive title of the filing. Omitted when the filing has no meaningful title.

itemsstring[]

Extracted item identifiers. For 10-K/10-Q: section numbers (e.g. "1A", "7"). For 8-K: SEC item codes (e.g. "2.02", "9.01"). For S-1: section keys (e.g. "risk-factors"). Omitted when no items are extracted. Use /api/filings/item to retrieve the full content of any listed item.

eventsstring[]

Developer-friendly event type names for 8-K filings. Omitted for non-8-K filings. See the event parameter for the full enum.

Example response

{
  "type": "8-K",
  "accessionNumber": "0000320193-23-000106",
  "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019323000106/aapl-20230930.htm",
  "dateFiled": "2023-11-02",
  "xbrl": true,
  "periodEndDate": "2023-09-30",
  "documents": [
    "g230399ex99_2p1g1.jpg",
    "g230399ex99_2p2g1.jpg"
  ],
  "title": "APPLE INC ANNUAL REPORT 2023",
  "items": [
    "1",
    "1A",
    "7",
    "7A",
    "8"
  ],
  "events": [
    "earnings",
    "financial_exhibits"
  ]
}