Skip to content

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 methodWhat it uses
explicit_headerThe amendment's SEC header names the original.
explicit_xmlThe filing's XML names the original (for example Schedule 13D/G).
original_dateA Form 4/A's date of the original submission.
period_matchThe same filer, base form and period of report.
date_items_matchFor 8-K filings: the same event date and items.
file_numberThe 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.

Shell
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.

EventWhenDetails
seenSEC Blast first observed the filing: SEC's list of new filings, a feed file, an index or the submissions data.
fetchedLive ingest downloaded and stored the complete submission.
releasedA private filing was made public. The filing's is_private_release is true and released_at gives the time.
finalizedAn authoritative source confirmed the filing; its status became final at finalized_at.
deliveredA later delivery of the filing was merged into its documents.
correctedIts 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_changedThe stored acceptance time changed, for example when SEC's submissions data supplies it.old, new, old_source, new_source
linkedAn amendment was linked to its original, or its link changed.
reconciledA reconciliation check of the filing against SEC's sources completed.
parsedA dataset extractor produced rows for the filing for the first time.dataset, extractor, version, status
parse_changedA 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