Skip to content
Searches page titles, headings, and route paths. Press slash to focus.

GET /v3/filings/{accession}

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

Parameters

string

This route needs an API key. Sign in to send it with yours; a free account comes with a key.

Python
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

JSON
{
  "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

NameInTypeRequiredDescription
accessionin pathstringyesrequiredAccession 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.

FieldTypeAlways presentDescription
accepted_atdate-time (RFC 3339, UTC) | nullyesalways presentWhen 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_at_snapshotdate-time (RFC 3339, UTC)noThe acceptance time SEC lists for the filing. UTC, ISO 8601. Present only when it differs from accepted_at by a second or more.
accepted_at_sourceanyyesalways presentWhere 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.
accessionstringyesalways presentThe filing's accession number, SEC's ID for it, such as 0000320193-24-000123.
base_formstringyesalways presentThe form type without the amendment suffix, such as 10-K.
deleted_atdate-time (RFC 3339, UTC) | nullyesalways presentWhen 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_countintegeryesalways presentNumber of documents in the filing; 0 while a live filing's documents are still being fetched.
feed_datedate (YYYY-MM-DD) | nullyesalways presentThe 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_datedate (YYYY-MM-DD)yesalways presentThe filing date SEC assigned. Calendar date YYYY-MM-DD, in US Eastern time.
first_seen_atdate-time (RFC 3339, UTC) | nullyesalways presentWhen SEC Blast first saw the filing. For a live filing, that is when it appeared in SEC's list of new filings. More
form_typestringyesalways presentForm type as filed, such as 10-K or 10-K/A.
header_in_filebooleanyesalways presentTrue 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_amendmentbooleanyesalways presentTrue when the form type is an amendment, such as 10-K/A; false otherwise.
is_inline_xbrlboolean | nullyesalways presentTrue 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_xbrlboolean | nullyesalways presentTrue 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.
itemsarray of stringyesalways presentThe 8-K item codes in the filing's header. Empty when there are none.
items_unmappedarray of stringyesalways presentItem descriptions in the header that have no item code yet. Empty when there are none.
linksobjectyesalways presentPaths of related resources in this API.
links.documentsstringyesalways presentThe path of the filing's document list.
links.eventsstringnoThe path of the filing's event history. Present only on GET /v3/filings/{accession}.
links.headerstring | nullyesalways presentThe path of the filing's SGML header. Null when header_in_file is false.
links.selfstringyesalways presentThe path of this filing.
period_of_reportdate (YYYY-MM-DD) | nullyesalways presentThe 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_of_report_headerdate (YYYY-MM-DD) | nullnoThe 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_of_report_sourcestring | nullyesalways presentWhere 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_cikstringyesalways presentThe 10-digit CIK of the primary filer.
primary_namestring | nullyesalways presentName 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.
provisionalbooleanyesalways presentTrue when status is provisional; false otherwise.
sec_itemsarray of string | nullyesalways presentArray 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_primary_doc_descriptionstring | nullyesalways presentSEC's description of the primary document. Null when SEC gives none. Present only on GET /v3/filings/{accession}.
sec_primary_documentstring | nullyesalways presentFile name of the primary document, according to SEC. Null when SEC does not name one.
sec_urlstring (URI)yesalways presentThe filing's index page on sec.gov.
snapshot_datedate (YYYY-MM-DD) | nullyesalways presentThe 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}.
sourcestringyesalways presentHow the filing reached SEC Blast. One of: feed, oldload, archives, realtime. What each means
statusstringyesalways presentOne of: provisional, final, deleted. What each means
total_bytesintegeryesalways presentTotal size of the filing's stored documents. In bytes.
date_of_changedate (YYYY-MM-DD) | nullyesalways presentThe 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.
deletedbooleanyesalways presentTrue when status is deleted; false otherwise.
deletionobject | nullyesalways presentWhere the deletion came from; SEC's deletion notice gives no reason. Null when the filing is not deleted.
deletion.feed_datedate (YYYY-MM-DD) | nullyesalways presentThe 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.noticestring | nullyesalways presentWhere 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.recorded_atdate-time (RFC 3339, UTC) | nullyesalways presentWhen SEC Blast recorded the deletion. UTC, ISO 8601. Null when no notice was recorded.
deletion.sourcestring | nullyesalways presentWhere the deletion notice came from. One of: feed (SEC's nightly feed, which carries deletion notices). Null when no notice was recorded.
documentsarray of Documentyesalways presentThe filing's documents, in sequence order.
effectiveness_datedate (YYYY-MM-DD) | nullyesalways presentThe date the filing takes effect, as the header states it (EFFECTIVENESS-DATE). Calendar date YYYY-MM-DD. Null when there is none.
entitiesarray of FilingEntityyesalways presentThe companies and people the filing's header names, in header order.
eventsarray of Eventyesalways presentThe filing's event history, oldest first.
finalized_atdate-time (RFC 3339, UTC) | nullyesalways presentWhen the filing became final. UTC, ISO 8601. Null when it is still provisional.
is_correctionbooleanyesalways presentTrue when SEC sent a correction notice that changed the filing's header values; false otherwise.
is_paperbooleanyesalways presentTrue for the record of a filing made on paper; false otherwise.
is_private_releasebooleanyesalways presentTrue when the filing was first filed privately and later made public by SEC; false otherwise.
liveobjectnoProgress of the live filing feed on this filing. Present only while the filing is provisional and came from the live filing feed.
live.documents_atdate-time (RFC 3339, UTC) | nullyesalways presentWhen its documents were added. UTC, ISO 8601. Null when they are not in yet.
live.listed_atdate-time (RFC 3339, UTC) | nullyesalways presentWhen the filing was listed. UTC, ISO 8601. Null when the live feed's seen event is missing.
live.statestringyesalways presentOne of: listed, complete, documents_failed. What each means
previous_accessionstring | nullyesalways presentThe 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_atdate-time (RFC 3339, UTC) | nullyesalways presentWhen SEC released a privately filed filing to the public. UTC, ISO 8601. Null when the filing was public from the start.
snapshotSnapshotyesalways presentThe copy of SEC's nightly company data behind the filing's SEC values.
versionsVersionsyesalways presentThe 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

StatusBodyMeaning
200FilingDetail (application/json)OK
404Problem (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