Skip to content

GET /v3/filings/{accession}/versions

Version chain of the filing's report: the original and every amendment, with how each amendment was linked. Members are ordered by amendment_seq (0 for the root, set when it is ingested; 1..n assigned to the amendments by the linker, null for an amendment it has not linked yet); the order of the amendments can still change until the snapshot lists every member.

API key: required. See Authentication.

Group: Filings

Parameters

NameInTypeRequiredDefaultDescription
accessionpathstringyesAccession number, with dashes (0001829126-26-010431) or without (18 digits).

Responses

StatusBodyDescription
200Versions (application/json)OK
400Problem (application/problem+json)Invalid or unknown parameter.
401Problem (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).
404Problem (application/problem+json)Not found.
503Problem (application/problem+json)Database unavailable; retry after the Retry-After delay.
defaultProblem (application/problem+json)Any other error (405, 500, 504).

Response body

A 200 carries a Versions object.

FieldTypeRequiredDescription
countintegernoMembers of the whole chain, deleted and not-ingested included.
itemsarray of objectno
items[].accepted_atdate-time (RFC 3339, UTC) | nullnoAs a filing's accepted_at; null for a member that is not ingested.
items[].accepted_at_snapshotdate-time (RFC 3339, UTC)noAs on a filing: only when SEC's value differs from accepted_at.
items[].accepted_at_sourcestring | nullno
items[].accessionstringno
items[].amendment_nointeger | nullno
items[].amendment_seqinteger | nullno0 for the root, 1..n for amendments in filing order. A filing that is not an amendment has 0 from the moment it is ingested; an amendment is null until the linker has linked it.
items[].amendment_typestring | nullno
items[].currentbooleanno
items[].filing_datedate (YYYY-MM-DD) | nullno
items[].form_typestring | nullno
items[].header_in_fileboolean | nullnoAs on GET /v3/filings/{accession}.
items[].ingestedbooleannoFalse for a root known only from an amendment's link.
items[].linkobjectno
items[].link.candidatesarray of objectnoPossible originals, shown for an ambiguous link.
items[].link.confidencenumber | nullno
items[].link.methodstring | nullnoOne of: explicit_header, explicit_xml, original_date, period_match, date_items_match, file_number, parties, filer_file_number, description_text, manual, null.
items[].link.statusstringnoOne of: resolved, ambiguous, unresolved, target_not_public, target_not_yet_ingested.
items[].primary_cikstring | nullno
items[].scopestring | nullno
items[].sec_urlstring | nullno
items[].statusstring | nullno
lateststring | nullnoNewest ingested, non-deleted member; null when every ingested member is deleted.
positionintegerno1-based place of this filing in the whole chain (not in items when truncated).
report_keystringnoAccession of the chain's root (the original filing, even when it is not ingested).
rootstringnoAlias of report_key.
snapshotSnapshotnoOn /v3/filings/{accession}/versions only; the block embedded in a filing has none (the filing carries it).
truncatedbooleannoTrue when the chain has more than 200 members and items holds 200 of them (always the root, this filing and the latest, then the nearest to this filing).

Example request

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

Open this route in the console

More in Filings

Previous: GET /v3/filings/{accession}/header · Next: GET /v3/reports

Markdown version: /docs/reference/get-filings-accession-versions.md