---
title: "Get a submission"
method: GET
path: "/submissions/{id}"
tags: ["Submissions"]
---

# Get a submission

`GET /submissions/{id}`

The API endpoint provides the functionality to retrieve information about a submission.

## Path parameters

- `id` integer, required

## Response `200`

OK

- object
  - `id` integer, required — Submission unique ID number.
  - `name` string — Name of the document submission.
  - `slug` string, required — Unique slug of the submission.
  - `source` 'invite' | 'bulk' | 'api' | 'embed' | 'link', required — The source of the submission.
  - `submitters_order` 'random' | 'preserved', required — The order of submitters.
  - `audit_log_url` string, nullable, required — Audit log file URL.
  - `combined_document_url` string, nullable, required — Combined PDF file URL with documents and Audit Log.
  - `created_at` string, required — The date and time when the submission was created.
  - `updated_at` string, required — The date and time when the submission was last updated.
  - `archived_at` string, nullable, required — The date and time when the submission was archived.
  - `submitters` object[], required — The list of submitters.
    - `id` integer, required — Submitter unique ID number.
    - `submission_id` integer, required — Submission unique ID number.
    - `uuid` string, required — Submitter UUID.
    - `email` string, nullable, required — The email address of the submitter.
    - `slug` string, required — Unique key to be used in the form signing link and embedded form.
    - `sent_at` string, nullable, required — The date and time when the signing request was sent to the submitter.
    - `opened_at` string, nullable, required — The date and time when the submitter opened the signing form.
    - `completed_at` string, nullable, required — The date and time when the submitter completed the signing form.
    - `declined_at` string, nullable, required — The date and time when the submitter declined the signing form.
    - `created_at` string, required — The date and time when the submitter was created.
    - `updated_at` string, required — The date and time when the submitter was last updated.
    - `name` string, nullable, required — The name of the submitter.
    - `phone` string, nullable, required — The phone number of the submitter.
    - `external_id` string, nullable, required — Your application-specific unique string key to identify this submitter within your app.
    - `status` 'completed' | 'declined' | 'opened' | 'sent' | 'awaiting', required — The status of signing request for the submitter.
    - `values` object[], required — An array of pre-filled values for the submitter.
      - `field` string, required — Document template field name.
      - `value` union, required — Pre-filled value of the field.
        - string
        - number
        - boolean
        - union[]
          - union
            - string
            - number
            - boolean
    - `documents` object[], required — An array of completed or signed documents by the submitter.
      - `name` string, required — Document name.
      - `url` string, required — Document URL.
    - `role` string, required — The role of the submitter in the signing process.
  - `template` object
    - `id` integer, required — Unique identifier of the document template.
    - `name` string, required — The name of the template.
    - `external_id` string, nullable, required — Your application-specific unique string key to identify this template within your app.
    - `folder_name` string, required — Folder name where the template is located.
    - `created_at` string, required — The date and time when the template was created.
    - `updated_at` string, required — The date and time when the template was last updated.
  - `created_by_user` object, nullable, required
    - `id` integer, required — Unique identifier of the user who created the submission.
    - `first_name` string, required — The first name of the user who created the submission.
    - `last_name` string, required — The last name of the user who created the submission.
    - `email` string, required — The email address of the user who created the submission.
  - `submission_events` object[], required — An array of events related to the submission.
    - `id` integer, required — Submission event unique ID number.
    - `submitter_id` integer, required — Unique identifier of the submitter that triggered the event.
    - `event_type` 'send_email' | 'bounce_email' | 'complaint_email' | 'send_reminder_email' | 'send_sms' | 'send_2fa_sms' | 'open_email' | 'click_email' | 'click_sms' | 'phone_verified' | 'start_form' | 'start_verification' | 'complete_verification' | 'view_form' | 'invite_party' | 'complete_form' | 'decline_form' | 'api_complete_form', required — Event type.
    - `event_timestamp` string, required — Date and time when the event was triggered.
    - `data` object — Additional event details object.
  - `documents` object[], required — An array of completed or signed documents of the submission.
    - `name` string, required — Document name.
    - `url` string, required — Document URL.
  - `status` 'completed' | 'declined' | 'expired' | 'pending', required — The status of the submission.
  - `metadata` object, required — Object with custom metadata.
  - `completed_at` string, nullable, required — The date and time when the submission was completed.

## Changes

> 6 revisions in range; 1 could not be searched.

- **2025-12-15** `c684e0b4cc66` — 1 info
  - added the optional property `submission_events/items/data` to the response with the `200` status
- **2025-06-26** `ddfeff66ea4f` — 1 breaking, 1 info
  - the response property `template` became optional for the status `200`
  - added the optional property `name` to the response with the `200` status
- **2025-05-18** `0d8d180a4ed5` — 14 breaking, 2 warning, 1 info
  - the response property `archived_at` became nullable for the status `200`
  - the response property `audit_log_url` became nullable for the status `200`
  - the response property `combined_document_url` became nullable for the status `200`
  - the response property `completed_at` became nullable for the status `200`
  - …13 more

[Change history](https://skmtc.dev/docusealco/apis/docuseal-api/changes/submissions/:id/get.md)

---

[API](https://skmtc.dev/docusealco/apis/docuseal-api.md) · [All operations](https://skmtc.dev/docusealco/apis/docuseal-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/docusealco/docuseal-api/revisions/c209c00c2386/schema)