SEC Filings

Filing by accession number

Changed on

Free Starter 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

Request

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)

acceptedAtstring date-time

EDGAR acceptance timestamp of the filing whose date sits next to it (dateFiled, or filingDate on insider transactions). Always ISO 8601 in UTC with second precision, e.g. 2024-11-01T10:01:36Z. Optional: omitted when that filing date is absent or the acceptance time is unknown (common for older filings and for the most recent ones, whose acceptance time is filled in after a short delay). Normally on the same calendar day as the filing date. Exceptions: a filing accepted after EDGAR's daily cutoff (5:30 p.m. ET for most forms, 10 p.m. ET for insider Forms 3, 4, 5 and 144) is dated the next business day, and an acceptance late in the Eastern evening is already the next day in UTC.

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-24-000123",
  "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm",
  "dateFiled": "2024-11-01",
  "acceptedAt": "2024-11-01T10:01:36Z",
  "xbrl": true,
  "periodEndDate": "2024-09-28",
  "documents": [
    "g230399ex99_2p1g1.jpg",
    "g230399ex99_2p2g1.jpg"
  ],
  "title": "APPLE INC ANNUAL REPORT 2024",
  "items": [
    "1",
    "1A",
    "7",
    "7A",
    "8"
  ],
  "events": [
    "earnings",
    "financial_exhibits"
  ]
}

Changes