---
title: "Get all surveys"
method: GET
path: "/api/v1/surveys/"
tags: ["surveys"]
---

# Get all surveys

`GET /api/v1/surveys/`

Get all the surveys for a researcher.

## Query parameters

- `researcher_id` string, required
- `offset` integer
- `limit` integer

## Headers

- `Authorization` string, required

## Response `200`

Successful Response

- GetAllSurveysResponse
  - `results` SurveyOut[], required — List of all surveys matching the criteria.
    - `_id` string — Auto generated by the system.
    - `date_created` string, date-time — The date/time the survey was created (UTC).
    - `date_modified` string, date-time — The date/time the survey was modified (UTC).
    - `researcher_id` string, required — The Prolific researcher ID.
    - `sections` SurveySection[] — Optional: An array of sections in the survey, otherwise `questions` will be defined.
      - `id` string, uuid — Auto generated by the system.
      - `questions` SurveyQuestion[], required — An array of questions a section within a Survey.
        - `answers` SurveyAnswerOption[], required — An array of answer options for a question.
          - `id` string, uuid
          - `value` string, required — The answer option value that can be selected.
        - `id` string, uuid
        - `title` string, required — The question title.
        - `type` 'single' | 'multiple', required — Responsible for articulating the question type. At the moment we have: - single answer - multiple answer Args: str (_type_): The type of question. Enum (_type_): The class to define an enum.
      - `title` string, required — The section title.
    - `questions` SurveyQuestion[] — Optional: An array of questions in the survey, otherwise `sections` will be defined.
      - `answers` SurveyAnswerOption[], required — An array of answer options for a question.
        - `id` string, uuid
        - `value` string, required — The answer option value that can be selected.
      - `id` string, uuid
      - `title` string, required — The question title.
      - `type` 'single' | 'multiple', required — Responsible for articulating the question type. At the moment we have: - single answer - multiple answer Args: str (_type_): The type of question. Enum (_type_): The class to define an enum.
    - `title` string, required — The survey title.

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