GET / v3/ filings/ {accession}
On this page
Get one filing.
Returns the filing with the companies and people named in it, its documents, its history events, and its amendments. Deleted filings are served too, with status deleted, deleted_at, and the deletion block. A filing known only from its deletion notice has no documents.
API key: required. See Authentication.
Group: Filings
Try it
This route needs an API key. Sign in to send it with yours; a free account comes with a key.
Response
import os
import requests
r = requests.get(
"https://api.secblast.com/v3/filings/0000320193-26-000026",
headers={"Authorization": f"Bearer {os.environ['SECBLAST_API_KEY']}"},
timeout=30,
)
r.raise_for_status()
print(r.json())Example answer
{
"accepted_at": "2026-11-03T13:05:15Z",
"accepted_at_source": "realtime",
"accession": "0000320193-26-000026",
"base_form": "10-K",
"date_of_change": "2026-11-03",
"deleted": false,
"deleted_at": null,
"deletion": null,
"doc_count": 105,
"documents": [
{
"decode_status": "ok",
"description": "10-K",
"encoding": "text",
"filename": "aapl-20260926.htm",
"is_primary": true,
"mime": "text/html",
"seq": 1,
"sha256": "bc6e71908b83b5260b23271176e4b8b709094670cb0f3bd8a9a44a9c91df8cbb",
"size_bytes": 1650003,
"type": "10-K",
"url": "/v3/filings/0000320193-26-000026/documents/1"
},
{
"decode_status": "ok",
"description": "EX-4.1",
"encoding": "text",
"filename": "a10-kexhibit4109262026.htm",
"is_primary": false,
"mime": "text/html",
"seq": 2,
"sha256": "0562da64f1a2a4f1f18aa9c51765443401ef0f19919acd304b527c25e5fd3315",
"size_bytes": 116408,
"type": "EX-4.1",
"url": "/v3/filings/0000320193-26-000026/documents/2"
}
],
"effectiveness_date": null,
"entities": [
{
"addresses": {
"business": {
"city": "CUPERTINO",
"phone": "(408) 996-1010",
"state": "CA",
"street1": "ONE APPLE PARK WAY",
"zip": "95014"
},
"mail": {
"city": "CUPERTINO",
"state": "CA",
"street1": "ONE APPLE PARK WAY",
"zip": "95014"
}
},
"cik": "0000320193",
"file_number": "001-36743",
"film_number": "261514222",
"fiscal_year_end": "0926",
"name": "Apple Inc.",
"role": "filer",
"sic": "3571",
"state_of_inc": "CA"
}
],
"events": [
{
"at": "2026-11-03T13:05:59Z",
"details": {
"accepted_at": "2026-11-03T13:05:15Z",
"accepted_rule": "header",
"atom_entities": [
{
"cik": "0000320193",
"role": "Filer"
}
],
"atom_form": "10-K",
"atom_position": 3,
"atom_start": 0,
"atom_updated": "2026-11-03T13:05:15Z",
"dedupe": "seen",
"download_time": "2026-11-03T13:05:59Z",
"first_seen_at": "2026-11-03T13:05:58Z",
"form": "10-K",
"header_acceptance": "2026-11-03T13:05:15Z",
"out_of_order": true,
"source_ref": "v3_raw/rt/20261103/0000320193-26-000026.txt.gz"
},
"event": "seen",
"seq": 41784675,
"source": "realtime"
},
{
"at": "2026-11-03T13:06:04Z",
"details": {
"bytes": 10902198,
"content_sha256": "b6edbd816db8613e5ad4a6c83fd8c4044ca539a57418e742decdef5b3ee8fd6e",
"date": "Tue, 03 Nov 2026 13:05:59 GMT",
"dedupe": "fetched|b6edbd816db8613e5ad4a6c83fd8c4044ca539a57418e742decdef5b3ee8fd6e",
"doc_count": 105,
"download_ms": 665,
"etag": "\"31ffe6dc0c90e9c204177c186e0513f5-gzip\"",
"last_modified": "Tue, 03 Nov 2026 13:05:55 GMT",
"source_ref": "v3_raw/rt/20261103/0000320193-26-000026.txt.gz",
"url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000026/0000320193-26-000026.txt"
},
"event": "fetched",
"seq": 41784676,
"source": "realtime"
}
],
"feed_date": "2026-11-03",
"filing_date": "2026-11-03",
"finalized_at": "2026-11-04T05:30:39Z",
"first_seen_at": "2026-11-03T13:05:58Z",
"form_type": "10-K",
"header_in_file": true,
"is_amendment": false,
"is_correction": false,
"is_inline_xbrl": true,
"is_paper": false,
"is_private_release": false,
"is_xbrl": true,
"items": [],
"items_unmapped": [],
"links": {
"documents": "/v3/filings/0000320193-26-000026/documents",
"events": "/v3/filings/0000320193-26-000026/events",
"header": "/v3/filings/0000320193-26-000026/header",
"self": "/v3/filings/0000320193-26-000026"
},
"period_of_report": "2026-09-26",
"period_of_report_source": "submissions",
"previous_accession": null,
"primary_cik": "0000320193",
"primary_name": "Apple Inc.",
"provisional": false,
"released_at": null,
"sec_items": [],
"sec_primary_doc_description": "10-K",
"sec_primary_document": "aapl-20260926.htm",
"sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000026/0000320193-26-000026-index.htm",
"snapshot": {
"available": true,
"date": "2026-11-17"
},
"snapshot_date": "2026-11-05",
"source": "feed",
"status": "final",
"total_bytes": 10656150,
"versions": {
"count": 1,
"items": [
{
"accepted_at": "2026-11-03T13:05:15Z",
"accepted_at_source": "realtime",
"accession": "0000320193-26-000026",
"amendment_seq": 0,
"current": true,
"filing_date": "2026-11-03",
"form_type": "10-K",
"ingested": true,
"status": "final"
}
],
"latest": "0000320193-26-000026",
"position": 1,
"report_key": "0000320193-26-000026",
"root": "0000320193-26-000026",
"truncated": false
}
}Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
accession | in path | string | yesrequired | Accession number: the SEC's ID for a filing, such as 0001829126-26-010431. The dashes are optional. |
Response body
A successful answer (200) is a FilingDetail object.
| Field | Type | Always present | Description |
|---|---|---|---|
accepted_ | date-time (RFC 3339, UTC) | null | yesalways present | When SEC accepted the filing. UTC, ISO 8601, e.g. 2026-11-18T16:00:41Z. Null when the time is not known; accepted_at_source says where it came from. |
accepted_ | date-time (RFC 3339, UTC) | no | The acceptance time SEC lists for the filing. UTC, ISO 8601. Present only when it differs from accepted_at by a second or more. |
accepted_ | any | yesalways present | Where accepted_at comes from: realtime, archives_txt, submissions_corrected, submissions_unverified, oldload, or submissions, as AcceptedAtSource explains; a later SEC value goes to accepted_at_snapshot. Null when accepted_at is null. One of: realtime, archives_txt, submissions_corrected, submissions_unverified, oldload, submissions. |
accession | string | yesalways present | The filing's accession number, SEC's ID for it, such as 0000320193-24-000123. |
base_ | string | yesalways present | The form type without the amendment suffix, such as 10-K. |
deleted_ | date-time (RFC 3339, UTC) | null | yesalways present | When SEC deleted the filing: the time on its deletion notice, or midnight US Eastern time on the day SEC published the notice when it has none. UTC, ISO 8601. Null when status is not deleted. |
doc_ | integer | yesalways present | Number of documents in the filing; 0 while a live filing's documents are still being fetched. |
feed_ | date (YYYY-MM-DD) | null | yesalways present | The day SEC published the filing in its nightly feed. Calendar date YYYY-MM-DD, in US Eastern time. Null when the feed has not delivered it. |
filing_ | date (YYYY-MM-DD) | yesalways present | The filing date SEC assigned. Calendar date YYYY-MM-DD, in US Eastern time. |
first_ | date-time (RFC 3339, UTC) | null | yesalways present | When SEC Blast first saw the filing. For a live filing, that is when it appeared in SEC's list of new filings. More |
form_ | string | yesalways present | Form type as filed, such as 10-K or 10-K/A. |
header_ | boolean | yesalways present | True when SEC's submission file has an SGML header: the block of labeled lines at the top that names the form, dates, and filers. False when it has none, as in some 1994-1995 files. More |
is_ | boolean | yesalways present | True when the form type is an amendment, such as 10-K/A; false otherwise. |
is_ | boolean | null | yesalways present | True when SEC says the filing uses Inline XBRL: financial data tagged inside the readable HTML document. False otherwise. Null when SEC does not say, or its data does not cover the filing yet. |
is_ | boolean | null | yesalways present | True when SEC says the filing has XBRL financial data; false otherwise. Null when SEC does not say, or its data does not cover the filing yet. |
items | array of string | yesalways present | The 8-K item codes in the filing's header. Empty when there are none. |
items_ | array of string | yesalways present | Item descriptions in the header that have no item code yet. Empty when there are none. |
links | object | yesalways present | Paths of related resources in this API. |
links. | string | yesalways present | The path of the filing's document list. |
links. | string | no | The path of the filing's event history. Present only on GET /v3/filings/{accession}. |
links. | string | null | yesalways present | The path of the filing's SGML header. Null when header_in_file is false. |
links. | string | yesalways present | The path of this filing. |
period_ | date (YYYY-MM-DD) | null | yesalways present | The period the filing reports on: SEC's report date when SEC gives one, else the date in the filing's header. Calendar date YYYY-MM-DD, as the company reported it. Null when neither gives one. |
period_ | date (YYYY-MM-DD) | null | no | The header's period, when SEC's report date replaced a different one. Calendar date YYYY-MM-DD. Null when the header has none. Present only on GET /v3/filings/{accession}, and only when the two differ. |
period_ | string | null | yesalways present | Where period_of_report comes from. One of: submissions (SEC's nightly company data) or header (the filing's header). Null when there is no period. |
primary_ | string | yesalways present | The 10-digit CIK of the primary filer. |
primary_ | string | null | yesalways present | Name of the primary filer as filed; without a header (header_in_file false), the name in SEC's index. Null when neither gives a name. |
provisional | boolean | yesalways present | True when status is provisional; false otherwise. |
sec_ | array of string | null | yesalways present | Array of 8-K item codes from SEC's own list, such as 2.02; items holds the header's list. Null when SEC's data does not cover the filing yet. |
sec_ | string | null | yesalways present | SEC's description of the primary document. Null when SEC gives none. Present only on GET /v3/filings/{accession}. |
sec_ | string | null | yesalways present | File name of the primary document, according to SEC. Null when SEC does not name one. |
sec_ | string (URI) | yesalways present | The filing's index page on sec.gov. |
snapshot_ | date (YYYY-MM-DD) | null | yesalways present | The date of the copy of SEC's nightly company data whose values were last written to the filing. Calendar date YYYY-MM-DD. Null when none was. Present only on GET /v3/filings/{accession}. |
source | string | yesalways present | How the filing reached SEC Blast. One of: feed, oldload, archives, realtime. What each means |
status | string | yesalways present | One of: provisional, final, deleted. What each means |
total_ | integer | yesalways present | Total size of the filing's stored documents. In bytes. |
date_ | date (YYYY-MM-DD) | null | yesalways present | The date the filer's details (such as name or address) changed, as the header states it (DATE-OF-CHANGE). Calendar date YYYY-MM-DD. Null when there is none. |
deleted | boolean | yesalways present | True when status is deleted; false otherwise. |
deletion | object | null | yesalways present | Where the deletion came from; SEC's deletion notice gives no reason. Null when the filing is not deleted. |
deletion. | date (YYYY-MM-DD) | null | yesalways present | The day SEC published the notice in its nightly feed. Calendar date YYYY-MM-DD, in US Eastern time. Null when no notice was recorded. |
deletion. | string | null | yesalways present | Where the notice sits in SEC's feed: the feed file's name, then #, then the entry's name in that file. Null when no notice was recorded. |
deletion. | date-time (RFC 3339, UTC) | null | yesalways present | When SEC Blast recorded the deletion. UTC, ISO 8601. Null when no notice was recorded. |
deletion. | string | null | yesalways present | Where the deletion notice came from. One of: feed (SEC's nightly feed, which carries deletion notices). Null when no notice was recorded. |
documents | array of Document | yesalways present | The filing's documents, in sequence order. |
effectiveness_ | date (YYYY-MM-DD) | null | yesalways present | The date the filing takes effect, as the header states it (EFFECTIVENESS-DATE). Calendar date YYYY-MM-DD. Null when there is none. |
entities | array of FilingEntity | yesalways present | The companies and people the filing's header names, in header order. |
events | array of Event | yesalways present | The filing's event history, oldest first. |
finalized_ | date-time (RFC 3339, UTC) | null | yesalways present | When the filing became final. UTC, ISO 8601. Null when it is still provisional. |
is_ | boolean | yesalways present | True when SEC sent a correction notice that changed the filing's header values; false otherwise. |
is_ | boolean | yesalways present | True for the record of a filing made on paper; false otherwise. |
is_ | boolean | yesalways present | True when the filing was first filed privately and later made public by SEC; false otherwise. |
live | object | no | Progress of the live filing feed on this filing. Present only while the filing is provisional and came from the live filing feed. |
live. | date-time (RFC 3339, UTC) | null | yesalways present | When its documents were added. UTC, ISO 8601. Null when they are not in yet. |
live. | date-time (RFC 3339, UTC) | null | yesalways present | When the filing was listed. UTC, ISO 8601. Null when the live feed's seen event is missing. |
live. | string | yesalways present | One of: listed, complete, documents_failed. What each means |
previous_ | string | null | yesalways present | The accession number of an earlier filing that this one refers back to, as the header states it (PREVIOUS-ACCESSION-NUMBER). Null when the header has none. |
released_ | date-time (RFC 3339, UTC) | null | yesalways present | When SEC released a privately filed filing to the public. UTC, ISO 8601. Null when the filing was public from the start. |
snapshot | Snapshot | yesalways present | The copy of SEC's nightly company data behind the filing's SEC values. |
versions | Versions | yesalways present | The report this filing belongs to: its original and amendments. |
Details
Sources
- accepted_at and period_of_report are the stored values.
- An acceptance time from the filing's header wins over SEC's, and SEC's report date wins over the header's period.
- accepted_at_snapshot gives SEC's time when it differs.
Responses
| Status | Body | Meaning |
|---|---|---|
200 | FilingDetail (application/json) | OK |
404 | Problem (application/problem+json) | Not found. |
Like every route, it can also answer with an error: 400, 401, 503, or another status. See Errors.
More in Filings
Previous: GET /v3/filings · Next: GET /v3/filings/{accession}/documents
Markdown version: /docs/reference/get-filings-accession.md