> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pollandroll.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Surveys

> List all the surveys in your organization.

## List the surveys

Retrieves all the surveys in your organization. Surveys are returned in descending order of creation (most recent first).

```http theme={null}
GET /api/v1/surveys
```

### Query parameters

Use these parameters to filter the records.

<ParamField query="status" type="string | array">
  Survey status or statuses to filter on. To pass several statuses in a URL, use the array format: `?status[]=complete&status[]=fieldwork`. See the list of possible values in the `status` field below.
</ParamField>

<ParamField query="updated_since" type="string">
  Date in ISO 8601 format. Returns all the records modified since this date, this date included. Example: `2025-09-19T10:43:16+02:00`.
</ParamField>

### Response fields

<ResponseField name="id" type="integer">
  ID of the record.
</ResponseField>

<ResponseField name="title" type="string">
  Title of the survey.
</ResponseField>

<ResponseField name="created_at" type="string">
  Date and time in ISO 8601 format, with time-zone offset.
</ResponseField>

<ResponseField name="updated_at" type="string">
  Date and time in ISO 8601 format, with time-zone offset.
</ResponseField>

<ResponseField name="hashid" type="string">
  Identifier of the survey used in URLs.
</ResponseField>

<ResponseField name="project_id" type="string">
  Customizable identifier set by the user.
</ResponseField>

<ResponseField name="status" type="string">
  Status of the survey. Possible values:

  * `draft`: the survey is being created.
  * `pending`: check before fieldwork opens (soft launch possible).
  * `fieldwork`: the survey's fieldwork is running.
  * `deviating_from_specs`: fieldwork paused because of deviations from the audience order specifications.
  * `data_processing`: data processing is running on the survey.
  * `complete`: the survey is complete.
  * `user_demo`: the survey is for demonstration purposes only.
</ResponseField>

<ResponseField name="owner_organization_id" type="integer">
  ID of the organization that owns the record.
</ResponseField>

<ResponseField name="transition_style" type="string">
  Questionnaire display mode used by the survey. Possible values:

  * `single_page`: single page — the new question appears once the previous one has been answered, as in a conversation.
  * `multiple_pages`: multiple pages — the new question appears on a new page.
</ResponseField>

<ResponseField name="respondent_questions_count" type="integer">
  Number of questions displayed to respondents in the survey.
</ResponseField>

<ResponseField name="respondent_iterations_count" type="integer">
  Number of question iterations displayed to respondents in the survey.
</ResponseField>

<Note>
  An **iteration** is a row entry in a grid question. For example: in a grid question, each row is an iteration; in a numerical question, each input field is an iteration; in a scale question, each scale is an iteration.
</Note>

<ResponseExample>
  ```json Response theme={null}
  {
    "surveys": [
      {
        "id": 1234,
        "title": "Etude de notoriété",
        "created_at": "2025-06-23T11:13:46.039+02:00",
        "updated_at": "2025-06-23T11:13:46.039+02:00",
        "hashid": "2meqJDmy",
        "project_id": null,
        "status": "draft",
        "owner_organization_id": 1,
        "transition_style": "single_page",
        "respondent_questions_count": 10,
        "respondent_iterations_count": 21
      },
      {
        "id": 1233,
        "title": "Etude test de concept",
        "created_at": "2025-06-19T12:22:16.144+02:00",
        "updated_at": "2025-06-19T12:22:20.041+02:00",
        "hashid": "KVQGneAj",
        "project_id": null,
        "status": "complete",
        "owner_organization_id": 1,
        "transition_style": "multiple_pages",
        "respondent_questions_count": 15,
        "respondent_iterations_count": 27
      }
    ],
    "pagination": {
      "current_page": 1,
      "next_page": 2,
      "prev_page": null,
      "total_pages": 105,
      "total_count": 2088
    }
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.