---
title: "Get a page of submissions"
method: GET
path: "/v4/submissions"
tags: ["Submissions"]
---

# Get a page of submissions

`GET /v4/submissions`

## Query parameters

- `continuationToken` string
- `size` integer
- `Search` string
- `PublicOrganizationIds.Include` string[]
- `PublicOrganizationIds.Exclude` string[]
- `Projects.Include` string[]
- `Projects.Exclude` string[]
- `Statuses.Include` string[]
- `Statuses.Exclude` string[]
- `Reviewers` string[]
- `ArchivedStatus` 'archived' | 'notArchived' | 'either', string
- `Labels.IncludeAny` string[]
- `Labels.IncludeAll` string[]
- `Labels.IncludeUnlabeled` boolean
- `Labels.ExcludeAny` string[]
- `Labels.ExcludeAll` string[]
- `Labels.ExcludeUnlabeled` boolean
- `DateFrom` string, date-time
- `DateTo` string, date-time
- `AdditionalFormStatuses` AdditionalFormsStatus[]
- `RequestFormStatuses` RequestFormsStatus[]
- `ReviewStatus` 'pending' | 'completed' | 'pendingOrCompleted', string
- `ReviewerProgress` 'pending' | 'completed' | 'pendingOrCompleted', string
- `ReviewStages.Include` string[]
- `ReviewStages.Exclude` string[]
- `SortBy.Field` 'submissionId' | 'submissionTitle' | 'date' | 'reviewStageScore' | 'submitterName' | 'publicOrgName' | 'organizationName' | 'projectTitle', string
- `SortBy.Order` 'ascending' | 'descending', string
- `LabelColors.IncludeAny` integer[]
- `LabelColors.ExcludeAny` integer[]

## Response `200`

Get a page of submissions

- ContinuationTokenResponseSubmissionListResponse
  - `continuationToken` string, nullable
  - `items` SubmissionListResponse[], nullable
    - `submissionId` string, uuid, nullable
    - `projectId` string, uuid, nullable
    - `submitterId` string, uuid, nullable
    - `reviewStageId` string, uuid, nullable
    - `submissionStatus` 'new' | 'in_progress' | 'accepted' | 'declined' | 'withdrawn' | 'completed' | 'editable' | 'viewed' | 'received' | 'published', nullable
    - `isArchived` boolean
    - `isPaid` boolean
    - `labels` string[], nullable
    - `reviewers` string[], nullable
    - `submitterFirstName` string, nullable
    - `submitterLastName` string, nullable
    - `submitterEmail` string, nullable
    - `submitterLastLoginDate` string, date-time, nullable
    - `submissionTitle` string, nullable
    - `projectTitle` string, nullable
    - `submissionDate` string, date-time
    - `isConcealed` boolean
    - `isInitialFormEntryEditable` boolean
    - `publicOrgId` string, uuid, nullable
    - `publicOrgVersion` integer, nullable
    - `publicOrgName` string, nullable
    - `concealPublicOrgName` boolean

## Other responses

- `400` — Invalid request
- `403` — Insufficient permissions

---

[API](https://skmtc.net/submittable/apis/submittable-api-documentation.md) · [All operations](https://skmtc.net/submittable/apis/submittable-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/submittable/submittable-api-documentation/revisions/254ce50c8212/schema)