# List every revision of a document `GET /documents/{id}/versions` **Required scope:** `documents:read` Pass the root id or any version in the chain; both return the whole chain, newest first. ## Parameters | Name | In | Required | Description | |---|---|---|---| | `id` | path | yes | id of the target record | ## Responses | Status | Meaning | |---|---| | `200` | Success | | `400` | BadRequest | | `401` | Unauthorized | | `403` | Forbidden | | `429` | RateLimited | ## Example ```bash curl -X GET "https://backend.immut.io/api/v1/documents//versions" \ -H "Authorization: Bearer $IMMUT_API_KEY" ``` ## OpenAPI fragment ```json { "/documents/{id}/versions": { "get": { "operationId": "getdocumentsidversions", "summary": "List every revision of a document. Pass the root id or any version in the chain; both return the whole chain, newest first.", "description": "List every revision of a document. Pass the root id or any version in the chain; both return the whole chain, newest first.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "id of the target record" } ], "responses": { "200": { "description": "Success" }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "tags": [ "Documents" ], "x-required-scope": "documents:read" } } } ```