# 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](https://www.secblast.com/docs/authentication).

**Group:** [Filings](https://www.secblast.com/docs/reference#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](https://www.secblast.com/docs/reference/schemas#schema-versions) (`application/json`) | OK |
| `400` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Invalid or unknown parameter. |
| `401` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-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](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Not found. |
| `503` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Database unavailable; retry after the Retry-After delay. |
| `default` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Any other error (405, 500, 504). |

## Response body

A `200` carries a [Versions](https://www.secblast.com/docs/reference/schemas#schema-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](https://www.secblast.com/docs/reference/schemas#schema-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

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

[Open this route in the console](https://www.secblast.com/console#get-v3-filings-accession-versions)

## More in Filings

Previous: [`GET /v3/filings/{accession}/header`](https://www.secblast.com/docs/reference/get-filings-accession-header) · Next: [`GET /v3/reports`](https://www.secblast.com/docs/reference/get-reports)
