# How changes are kept

Filings change after they are filed: companies amend them, and SEC corrects and redelivers them. SEC Blast keeps each change and links it to what it changed.

## Amendments and their originals

[`GET /v3/filings/{accession}/versions`](https://www.secblast.com/docs/reference/get-filings-accession-versions) gives a filing's whole chain: the original and every amendment, in filing order (`amendment_seq` 0 for the original, 1 to n for the amendments). Each member carries how it was linked:

| Link method | What it uses |
|---|---|
| `explicit_header` | The amendment's SEC header names the original. |
| `explicit_xml` | The filing's XML names the original (for example Schedule 13D/G). |
| `original_date` | A Form 4/A's date of the original submission. |
| `period_match` | The same filer, base form and period of report. |
| `date_items_match` | For 8-K filings: the same event date and items. |
| `file_number` | The same SEC file number. |

A link's `status` is `resolved`, `ambiguous` (the candidates are listed), `unresolved`, `target_not_public` or `target_not_yet_ingested`. [`GET /v3/reports`](https://www.secblast.com/docs/reference/get-reports) lists a company's reports, one row per chain. [`GET /v3/filings`](https://www.secblast.com/docs/reference/get-filings) takes `amendments=include\|exclude\|only`.

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

## Every event of a filing

[`GET /v3/filings/{accession}/events`](https://www.secblast.com/docs/reference/get-filings-accession-events) lists what happened to a filing, oldest first. Each event has its kind, its time, its `source` (the process that recorded it, for example `realtime`, `feed`, `reconcile` or `snapshot_sync`) and its `details`. [`GET /v3/filings/{accession}`](https://www.secblast.com/docs/reference/get-filings-accession) carries the same list as `events`.

| Event | When | Details |
|---|---|---|
| `seen` | SEC Blast first observed the filing: SEC's list of new filings, a feed file, an index or the submissions data. |   |
| `fetched` | Live ingest downloaded and stored the complete submission. |   |
| `released` | A private filing was made public. The filing's `is_private_release` is true and `released_at` gives the time. |   |
| `finalized` | An authoritative source confirmed the filing; its status became final at `finalized_at`. |   |
| `delivered` | A later delivery of the filing was merged into its documents. |   |
| `corrected` | Its header or documents changed, on reconciliation or by an SEC correction. The filing's `is_correction` is true and `date_of_change` gives the latest date of change in SEC's header. |   |
| `accepted_changed` | The stored acceptance time changed, for example when SEC's submissions data supplies it. | `old`, `new`, `old_source`, `new_source` |
| `linked` | An amendment was linked to its original, or its link changed. |   |
| `reconciled` | A reconciliation check of the filing against SEC's sources completed. |   |
| `parsed` | A dataset extractor produced rows for the filing for the first time. | `dataset`, `extractor`, `version`, `status` |
| `parse_changed` | A re-parse or a changed input changed, added or removed the filing's parsed rows. | `dataset`, `extractor`, versions, counts |

`previous_accession` is the earlier filing a filing names as the one it amends or replaces, where its header or XML names one; [`GET /v3/filings/{accession}/versions`](https://www.secblast.com/docs/reference/get-filings-accession-versions) shows the link made from it.

## Redeliveries

When SEC delivers a filing more than once, the deliveries are merged: [`GET /v3/filings/{accession}/documents`](https://www.secblast.com/docs/reference/get-filings-accession-documents) serves, for each document, the newest delivery's copy. A changed document gets a new `ETag`, and the filing gets a `delivered` event.

## Provisional and final

A filing's `status` is `provisional` from live ingest until SEC's nightly feed file confirms it, then `final`. `accepted_at_source` says where `accepted_at` came from, and `accepted_at_snapshot` gives SEC's own value when it differs.
