# GET /v3/filings/{accession}

One filing with entities, documents, events and its version chain. A filing SEC deleted (withdrew) is served like any other: status deleted, deleted true, deleted_at and the deletion block; its documents when they were delivered (a filing known only from its deletion notice has none). accepted_at and period_of_report are the stored values (see the Filing schema: a header time wins over SEC's, SEC's reportDate over the header's period); accepted_at_snapshot gives SEC's time when it differs.

**API key:** required. See [Authentication](https://www.secblast.com/docs/authentication).

**Group:** [Filings](https://www.secblast.com/docs/reference#filings)

## Parameters

| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
| `accession` | path | string | yes |   | Accession number, with dashes (0001829126-26-010431) or without (18 digits). |

## Responses

| Status | Body | Description |
|---|---|---|
| `200` | [FilingDetail](https://www.secblast.com/docs/reference/schemas#schema-filingdetail) (`application/json`) | OK |
| `400` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Invalid or unknown parameter. |
| `401` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Missing, invalid or inactive API key (code unauthorized), or a refused access token (code invalid_token: malformed, unknown key, bad signature, expired, wrong issuer or audience, revoked grant). WWW-Authenticate names the protected-resource metadata (RFC 9728). |
| `404` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Not found. |
| `503` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Database unavailable; retry after the Retry-After delay. |
| `default` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Any other error (405, 500, 504). |

## Response body

A `200` carries a [FilingDetail](https://www.secblast.com/docs/reference/schemas#schema-filingdetail) object.

| Field | Type | Required | Description |
|---|---|---|---|
| `accepted_at` | date-time (RFC 3339, UTC) \| null | no | The acceptance time stored in v3. A time from the filing's own header (source realtime or archives_txt) always wins over SEC's; once stored a time does not move (a later SEC value goes to accepted_at_snapshot). Otherwise SEC's submissions value: for a filing new since the previous snapshot sync, SEC's value minus the New York UTC offset (SEC's values carry that offset), source submissions_corrected; for history, SEC's value as given, source submissions_unverified (it may carry 0, 1 or 2 such offsets). Null when no source has a time. |
| `accepted_at_snapshot` | date-time (RFC 3339, UTC) | no | Present only when SEC's submissions value differs from accepted_at (at whole seconds): SEC's value as given. |
| `accepted_at_source` | string \| null | no | realtime / archives_txt: from the filing's header (live ingest / SEC Archives). submissions_corrected, submissions_unverified: from SEC's submissions snapshot (see accepted_at). oldload and submissions are not written any more. One of: `realtime`, `archives_txt`, `submissions_corrected`, `submissions_unverified`, `oldload`, `submissions`, `null`. |
| `accession` | string | yes |   |
| `base_form` | string | yes |   |
| `deleted_at` | date-time (RFC 3339, UTC) \| null | no |   |
| `doc_count` | integer | no |   |
| `feed_date` | date (YYYY-MM-DD) \| null | no |   |
| `filing_date` | date (YYYY-MM-DD) | yes |   |
| `first_seen_at` | date-time (RFC 3339, UTC) \| null | no |   |
| `form_type` | string | yes | Form type as filed. |
| `header_in_file` | boolean | no | Single filing only. false: SEC's submission file of the filing has no SGML header (part of the 1994-1995 Archives files hold only their documents); its form type, filing date and filers are SEC's submissions index values, links.header is null and /header answers 404 with reason no_header_in_file. |
| `is_amendment` | boolean | yes |   |
| `is_inline_xbrl` | boolean \| null | no | SEC's isInlineXBRL; null as is_xbrl. |
| `is_xbrl` | boolean \| null | no | SEC's isXBRL; null when SEC does not say or the snapshot sync has not seen the filing. |
| `items` | array of string | no |   |
| `items_unmapped` | array of string | no |   |
| `links` | object | yes |   |
| `links.documents` | string | no |   |
| `links.events` | string | no |   |
| `links.header` | string \| null | no | null when header_in_file is false (single filing). |
| `links.self` | string | no |   |
| `period_of_report` | date (YYYY-MM-DD) \| null | no | SEC's reportDate (submissions snapshot) when it gives one, otherwise the value in the filing's header. |
| `period_of_report_header` | date (YYYY-MM-DD) \| null | no | Single filing only, and only when SEC's reportDate replaced a different header period: the header's (null: the header has none). |
| `period_of_report_source` | string \| null | no | One of: `submissions`, `header`, `null`. |
| `primary_cik` | string | yes |   |
| `primary_name` | string \| null | no | Name of the primary entity as filed (header_in_file false: the name SEC's submissions index gives for the filing date, or null). |
| `provisional` | boolean | no | status == provisional. |
| `sec_items` | array of string \| null | no | SEC's 8-K items list (items is the header's); null when the snapshot sync has not seen the filing. |
| `sec_primary_doc_description` | string \| null | no | Single filing only: SEC's primaryDocDescription. |
| `sec_primary_document` | string \| null | no | SEC's primaryDocument (file name). |
| `sec_url` | string (URI) | yes |   |
| `snapshot_date` | date (YYYY-MM-DD) \| null | no | Single filing only: the snapshot whose values were last written to the filing; null when none was. |
| `source` | string | no | realtime: registered by live ingest; it becomes feed when the nightly feed delivers the filing. One of: `feed`, `oldload`, `archives`, `realtime`. |
| `status` | string | yes | provisional: registered by live ingest and not yet confirmed by the nightly feed, which makes it final (and may replace its documents). deleted: SEC deleted (withdrew) the filing; it is still served, with its documents when they were delivered (deleted_at, and the deletion block on the single filing). One of: `provisional`, `final`, `deleted`. |
| `total_bytes` | integer | no |   |
| `date_of_change` | date (YYYY-MM-DD) \| null | no |   |
| `deleted` | boolean | no | status == deleted. |
| `deletion` | object \| null | no | Only for a deleted filing (null otherwise): where the deletion came from. SEC's DELETION notice gives no reason. |
| `deletion.feed_date` | date (YYYY-MM-DD) \| null | no | The feed day whose archive held the notice. |
| `deletion.notice` | string \| null | no | The notice member, \<archive\>#\<member\>. |
| `deletion.recorded_at` | date-time (RFC 3339, UTC) \| null | no | When v3 registered the deletion. |
| `deletion.source` | string \| null | no | Where the deletion notice came from, as the filing's events say it: feed (SEC's nightly feed, which carries the notices) for every deletion today. |
| `documents` | array of [Document](https://www.secblast.com/docs/reference/schemas#schema-document) | no |   |
| `effectiveness_date` | date (YYYY-MM-DD) \| null | no |   |
| `entities` | array of [FilingEntity](https://www.secblast.com/docs/reference/schemas#schema-filingentity) | no |   |
| `events` | array of [Event](https://www.secblast.com/docs/reference/schemas#schema-event) | no |   |
| `finalized_at` | date-time (RFC 3339, UTC) \| null | no |   |
| `is_correction` | boolean | no |   |
| `is_paper` | boolean | no |   |
| `is_private_release` | boolean | no |   |
| `live` | object | no | Only while the filing is provisional and its source is realtime: where live ingest is with it. Gone once the filing is final. |
| `live.documents_at` | date-time (RFC 3339, UTC) \| null | no | When its documents were registered; null until then. |
| `live.listed_at` | date-time (RFC 3339, UTC) \| null | no | When the filing was listed. |
| `live.state` | string | no | listed: the header is registered (entities, items, acceptance time, /header); doc_count is 0 and the documents are still being fetched. complete: the documents are registered. documents_failed: they could not be fetched; the nightly feed will supply them. One of: `listed`, `complete`, `documents_failed`. |
| `previous_accession` | string \| null | no |   |
| `released_at` | date-time (RFC 3339, UTC) \| null | no |   |
| `snapshot` | [Snapshot](https://www.secblast.com/docs/reference/schemas#schema-snapshot) | no |   |
| `versions` | [Versions](https://www.secblast.com/docs/reference/schemas#schema-versions) | no |   |

## Example request

```bash
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
  'https://api.secblast.com/v3/filings/0001829126-26-010431'
```

[Open this route in the console](https://www.secblast.com/console#get-v3-filings-accession)

## More in Filings

Previous: [`GET /v3/filings`](https://www.secblast.com/docs/reference/get-filings) · Next: [`GET /v3/filings/{accession}/documents`](https://www.secblast.com/docs/reference/get-filings-accession-documents)
