---
title: "List submissions"
method: GET
path: "/api/v1/submissions/"
tags: ["submissions"]
---

# List submissions

`GET /api/v1/submissions/`

Returns basic information of submissions, including study id, participant id, status and start timestamp.

**Filtering and Ordering:**
- Filter by status, completion state, dates, and study
- Order by start time, reward amount, or study name
- Paginate by page_size and page (Default page_size is 20)
- Boolean parameters accept multiple formats: 1/0, true/false, yes/no, t/f (case-insensitive)
- Date parameters use DD/MM/YYYY format
- Status parameters are case-insensitive with underscore normalization

## Query parameters

- `study` string, required
- `status` 'ACTIVE' | 'AWAITING_REVIEW' | 'APPROVED' | 'PARTIALLY_APPROVED' | 'REJECTED' | 'RETURNED' | 'SCREENED_OUT' | 'TIMED-OUT' | 'UNKNOWN'
- `completed` '0' | '1' | 'true' | 'false' | 'yes' | 'no' | 't' | 'f'
- `returned` '0' | '1' | 'true' | 'false' | 'yes' | 'no' | 't' | 'f'
- `awaiting_review` '0' | '1' | 'true' | 'false' | 'yes' | 'no' | 't' | 'f'
- `approved` '0' | '1' | 'true' | 'false' | 'yes' | 'no' | 't' | 'f'
- `active` '0' | '1' | 'true' | 'false' | 'yes' | 'no' | 't' | 'f'
- `timeout` '0' | '1' | 'true' | 'false' | 'yes' | 'no' | 't' | 'f'
- `rejected` '0' | '1' | 'true' | 'false' | 'yes' | 'no' | 't' | 'f'
- `screened_out` '0' | '1' | 'true' | 'false' | 'yes' | 'no' | 't' | 'f'
- `completeoractive` '0' | '1' | 'true' | 'false' | 'yes' | 'no' | 't' | 'f'
- `submitted_from` string
- `submitted_before` string
- `ordering` 'started_at' | '-started_at' | 'submission_reward' | '-submission_reward' | 'study_name' | '-study_name'
- `page_size` integer
- `page` integer

## Headers

- `Authorization` string, required

## Response `200`

List submissions

- SubmissionListResponse
  - `results` SubmissionShort[], required — List of all submissions matching the criteria.
    - `id` string, required — Submission id.
    - `participant_id` string, required — Participant id.
    - `status` 'RESERVED' | 'ACTIVE' | 'TIMED-OUT' | 'AWAITING REVIEW' | 'APPROVED' | 'RETURNED' | 'REJECTED' | 'SCREENED OUT', required — Status of the submission.
    - `started_at` string, date-time, required — Date started
    - `completed_at` string, date-time, nullable — Date completed
    - `has_siblings` boolean, required — Whether or not the submission has sibling submissions (sharing the same study).
    - `study_code` string, nullable — The completion code used by the participant to complete the study.
    - `return_requested` string, date-time, nullable — The date and time when a return request for the submission was made.

## Other responses

- `400` — Error

---

[API](https://skmtc.net/prolific/apis/api-reference.md) · [All operations](https://skmtc.net/prolific/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prolific/api-reference/versions/dc6f073a9827/schema)