---
title: "List study submissions"
method: GET
path: "/api/v1/studies/{id}/submissions/"
tags: ["studies"]
---

# List study submissions

`GET /api/v1/studies/{id}/submissions/`

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

## Path parameters

- `id` string, required

## Query parameters

- `ordering` string

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