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.
accessionNumber string required The SEC accession number (e.g. 0000320193-23-000106)
curl 'https://api.stockfit.io/v1/api/filings/search-by-accession-number?accessionNumber=0000320193-23-000106' \
-H 'Authorization: Bearer YOUR_API_TOKEN'The SEC filing
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.
{
"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"
]
}Invalid parameters or filing not found
error string Human-readable error message
{
"error": "Error description goes here"
}Feature not available on current plan, or filing is outside your plan's data limit
error string Human-readable error message
{
"error": "Error description goes here"
}