Dashboard

Filing by accession number

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

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 key Try it live in the API explorer

Query parameters

Example request

curl 'https://api.stockfit.io/v1/api/filings/search-by-accession-number?accessionNumber=0000320193-23-000106' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

The SEC filing

Response schema

  • type string

    SEC form type

  • accessionNumber string

    SEC accession number

  • url string

    URL to the filing document

  • dateFiled string

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

  • acceptedAt string (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.

  • xbrl boolean

    Whether the filing includes XBRL data

  • amendment boolean

    Whether this filing is an amendment

  • periodEndDate string

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

  • documents array of string

    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.

  • title string

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

  • items array of string

    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.

  • events array of string

    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,
  "amendment": false,
  "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"
  ]
}

400 Bad Request

Invalid parameters or filing not found

Response schema

  • error string

    Human-readable error message

Example response

{
  "error": "Error description goes here"
}

403 Forbidden

Feature not available on current plan, or filing is outside your plan's data limit

Response schema

  • error string

    Human-readable error message

Example response

{
  "error": "Error description goes here"
}