---
title: "Study participants"
method: GET
path: "/v1/studies/{study_id}/participants"
tags: ["Studies"]
---

# Study participants

`GET /v1/studies/{study_id}/participants`

Lists participants of a study, paginated to 100 participants per page

## Path parameters

- `study_id` integer, required

## Query parameters

- `status` 'fresh' | 'invited' | 'applied' | 'shortlisted' | 'approved' | 'requested' | 'booked' | 'completed' | 'rejected' | 'started' | 'no_show' | 'opted_out' | 'canceled'
- `status[]` string[]
- `page` integer

## Response `200`

successful

- object
  - `data` StudyParticipant[], required
    - `id` string
    - `type` 'participant'
    - `attributes` object
      - `id` integer
      - `name` string
      - `first_name` string
      - `token` string
      - `status` string
      - `phone_number` string
      - `join_url` string
      - `duration_in_minutes` integer
      - `completed_at` string, date-time
      - `interview_at` string, date-time
      - `requested_at` string, date-time
      - `applied_at` string, date-time
      - `shortlisted_at` string, date-time
      - `rejected_at` string, date-time
      - `no_show_at` string, date-time
      - `opted_out_at` string, date-time
      - `started_at` string, date-time
      - `canceled_at` string, date-time
      - `invited_at` string, date-time
      - `thanked_at` string, date-time
      - `reschedule_requested_at` string, date-time
      - `booked_at` string, date-time
      - `action_required` boolean
      - `consent_info` string
      - `consent` string
      - `opted_in` boolean
      - `consent_token` string
      - `email` string
      - `external` boolean
      - `external_completion_url` string
      - `in_request_batch` boolean
      - `event_details` object, nullable
        - `start_time` string, date-time
  - `meta` Pagy
    - `count` integer
    - `page` integer
    - `items` integer
    - `pages` integer

## Other responses

- `401` — unauthorized
- `404` — other account

---

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