---
title: "Get Workflow Submission Revisions"
method: GET
path: "/workflows/{workflowId}/submissions/{submissionId}/revisions"
tags: ["Revisions"]
---

# Get Workflow Submission Revisions

`GET /workflows/{workflowId}/submissions/{submissionId}/revisions`

## Request

- Base URL: `https://env.unqork.io/api/1.0`
- URL: `https://env.unqork.io/api/1.0/workflows/{workflowId}/submissions/{submissionId}/revisions`
- Auth: OAuth 2
  - Client credentials
  - Password
  - Token URL: `https://xyzfinancial.unqork.io/api/1.0/oauth2/access_token`
- TypeScript: <https://skmtc.dev/unqork/apis/unqork-customer-api/docs/workflows/:workflowId/submissions/:submissionId/revisions/get.ts> (a function with typed inputs; its response is checked against the schema)

Gets all revisions for a submission. The data field is left empty.
### Authorization Required:
  - See Submission Access ([Submission Access](#submission-access))

## Path parameters

- `workflowId` string, required
- `submissionId` string, required

## Query parameters

- `limit` integer
- `offset` integer
- `sortBy` string
- `sortOrder` 1 | -1
- `metadataFilter` string

## Response `200`

Revisions

- RetrievedRevisionsResponse[]
  - `id` string, required: Revision id
  - `created` string: Date of when the submission was created or modified (might be missing in old submissions)
  - `createdBy` string: Creator or modifier of the submission (might be missing in old submissions)
  - `persistedInWormStorage` boolean: whether the revision is WORM (Write-Once-Read-Many) compliant. [Click here](https://www.17a-4.com/regulations-summary/) for more information
  - `submission` object, required: Submission object
    - `id` string
    - `userId` string: Submission owner
    - `formId` string
    - `created` string, date-time
    - `modified` string, date-time
    - `deleted` string, date-time
    - `metadata` object
    - `formArchive` string: The form version the revision was saved under
  - `validationErrors` object[]
    - `id` string
    - `path` string
    - `label` string
    - `parent` string
    - `message` string

## Other responses

- `default`: Error

## Changes

- **2026-08-10** `112399a67ebb`: 1 warning
  - removed the optional property `items/submission/data` from the response with the `200` status

[Operation history](https://skmtc.dev/unqork/apis/unqork-customer-api/changes/workflows/:workflowId/submissions/:submissionId/revisions/get.md)

---

[API](https://skmtc.dev/unqork/apis/unqork-customer-api.md) - [All operations](https://skmtc.dev/unqork/apis/unqork-customer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/unqork/apis/unqork-customer-api/revisions/13dad4096373?raw)