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 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 lists a company's reports, one row per chain. GET /v3/filings takes amendments=include|exclude|only.
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 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} 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 shows the link made from it.
Redeliveries
When SEC delivers a filing more than once, the deliveries are merged: GET /v3/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.
Markdown version: /docs/changes.md