---
title: "List all submissions"
method: GET
path: "/submissions"
tags: ["Submissions"]
---

# List all submissions

`GET /submissions`

The API endpoint provides the ability to retrieve a list of available submissions.

## Query parameters

- `template_id` integer
- `status` 'pending' | 'completed' | 'declined' | 'expired'
- `q` string
- `slug` string
- `template_folder` string
- `archived` boolean
- `limit` integer
- `after` integer
- `before` integer

## Response `200`

OK

- object
  - `data` object[], required
    - `id` integer, required — Submission unique ID number.
    - `name` string — Name of the document submission.
    - `source` 'invite' | 'bulk' | 'api' | 'embed' | 'link', required — The source of the submission.
    - `slug` string, required — Unique slug of the submission.
    - `status` 'completed' | 'declined' | 'expired' | 'pending', required — The status 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 — Combined PDF file URL with documents and Audit Log.
    - `completed_at` string, nullable, required — The date and time when the submission was completed.
    - `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 — 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 — 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.
      - `role` string, required — The role of the submitter in the signing process.
      - `metadata` object, required — Metadata object with additional submitter information.
      - `preferences` object, required — Submitter preferences.
    - `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.
  - `pagination` object, required
    - `count` integer, required — Submissions count.
    - `next` integer, nullable, required — The ID of the submission after which the next page starts.
    - `prev` integer, nullable, required — The ID of the submission before which the previous page ends.

---

[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)