# List File Versions (/docs/api-reference/list_file_versions)

`GET /v1/files/{file_id}/versions` · operation `list_file_versions`

Lists the 100 most recent versions of an accessible File, newest first, and marks the one in use. Versions still uploading or blocked by scanning are listed with their processing status. People who can only view the File see just the version in use.

**Sign-in:** a signed-in person's access token (`Authorization: Bearer …`), which AI apps get through MCP sign-in; or a Workspace API key in the `X-SMB-API-Key` header.

### Path parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `file_id` | string | yes | Stable File ID. |

### Headers

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `SMB-Workspace-Id` | string (uuid) | yes | Workspace where this operation runs. Required for user tokens and Workspace API keys. |

### Response

**200** Successful authorized response.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `versions` | array of object | yes |  |
| `versions[].file_version_id` | string | yes | Immutable File version ID. |
| `versions[].version_number` | integer | yes |  |
| `versions[].content_type` | string | yes |  |
| `versions[].size_bytes` | integer | yes |  |
| `versions[].sha256` | string or null | yes |  |
| `versions[].processing_status` | one of `pending_upload`, `processing`, `ready`, `quarantined`, `failed` | yes |  |
| `versions[].processing_error` | string or null | no | Upload processing failure code, when available. |
| `versions[].summary` | string or null | no | What changed in this version, when the author said. |
| `versions[].created_by` | object | no |  |
| `versions[].created_at` | string (date-time) | yes |  |
| `versions[].ready_at` | string (date-time) or null | yes |  |
| `versions[].protection` | object or null | no | What SMB's check for private numbers found: state, reason, items (kind and page, never a number), hidden. Null if unchecked. |
| `versions[].redacted_from` | string or null | no | Copy's original version. |
| `versions[].redacted_copy` | string or null | no | Original's redacted copy. |
| `versions[].current` | boolean | yes | Whether this is the version the File shows now. |
| `request_id` | string | yes |  |

### Errors

- `400` The request is invalid.
- `401` Authentication is required.
- `403` The caller is not authorized.
- `404` The resource was not found.
- `409` The resource revision or idempotency input conflicts.
- `413` The request body is too large.
- `415` The request must be JSON.
- `422` Required evidence is missing.
- `429` Rate limit reached; honor Retry-After.
- `500` The request could not be completed.
- `502` A dependency returned an invalid response.
- `503` The service is temporarily unavailable.

### Example

```bash
curl --request GET "https://api.smb.co/v1/files/$FILE_ID/versions" \
  --header "Authorization: Bearer $ACCESS_TOKEN" \
  --header "SMB-Workspace-Id: $WORKSPACE_ID"
```