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
| 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 | Versions (application/json) | OK |
400 | Problem (application/problem+json) | Invalid or unknown parameter. |
401 | 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 (application/problem+json) | Not found. |
503 | Problem (application/problem+json) | Database unavailable; retry after the Retry-After delay. |
default | Problem (application/problem+json) | Any other error (405, 500, 504). |
Response body
A 200 carries a Versions object.
| Field | Type | Required | Description |
|---|---|---|---|
count | integer | no | Members of the whole chain, deleted and not-ingested included. |
items | array of object | no | |
items[].accepted_at | date-time (RFC 3339, UTC) | null | no | As a filing's accepted_at; null for a member that is not ingested. |
items[].accepted_at_snapshot | date-time (RFC 3339, UTC) | no | As on a filing: only when SEC's value differs from accepted_at. |
items[].accepted_at_source | string | null | no | |
items[].accession | string | no | |
items[].amendment_no | integer | null | no | |
items[].amendment_seq | integer | null | no | 0 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_type | string | null | no | |
items[].current | boolean | no | |
items[].filing_date | date (YYYY-MM-DD) | null | no | |
items[].form_type | string | null | no | |
items[].header_in_file | boolean | null | no | As on GET /v3/filings/{accession}. |
items[].ingested | boolean | no | False for a root known only from an amendment's link. |
items[].link | object | no | |
items[].link.candidates | array of object | no | Possible originals, shown for an ambiguous link. |
items[].link.confidence | number | null | no | |
items[].link.method | string | null | no | One of: explicit_header, explicit_xml, original_date, period_match, date_items_match, file_number, parties, filer_file_number, description_text, manual, null. |
items[].link.status | string | no | One of: resolved, ambiguous, unresolved, target_not_public, target_not_yet_ingested. |
items[].primary_cik | string | null | no | |
items[].scope | string | null | no | |
items[].sec_url | string | null | no | |
items[].status | string | null | no | |
latest | string | null | no | Newest ingested, non-deleted member; null when every ingested member is deleted. |
position | integer | no | 1-based place of this filing in the whole chain (not in items when truncated). |
report_key | string | no | Accession of the chain's root (the original filing, even when it is not ingested). |
root | string | no | Alias of report_key. |
snapshot | Snapshot | no | On /v3/filings/{accession}/versions only; the block embedded in a filing has none (the filing carries it). |
truncated | boolean | no | True 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
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