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

# Études

> Lister toutes les études de votre organisation.

## Lister les études

Récupère toutes les études de votre organisation. Les études sont renvoyées par ordre de création décroissant (la plus récente en premier).

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

### Paramètres de requête

Utilisez ces paramètres pour filtrer les enregistrements.

<ParamField query="status" type="string | array">
  Statut(s) d'étude à filtrer. Pour passer plusieurs statuts dans une URL, utilisez le format tableau : `?status[]=complete&status[]=fieldwork`. Voir la liste des valeurs possibles dans le champ `status` ci-dessous.
</ParamField>

<ParamField query="updated_since" type="string">
  Date au format ISO 8601. Renvoie tous les enregistrements modifiés depuis cette date, celle-ci incluse. Exemple : `2025-09-19T10:43:16+02:00`.
</ParamField>

### Champs de réponse

<ResponseField name="id" type="integer">
  ID de l'enregistrement.
</ResponseField>

<ResponseField name="title" type="string">
  Titre de l'étude.
</ResponseField>

<ResponseField name="created_at" type="string">
  Date et heure au format ISO 8601, avec décalage horaire.
</ResponseField>

<ResponseField name="updated_at" type="string">
  Date et heure au format ISO 8601, avec décalage horaire.
</ResponseField>

<ResponseField name="hashid" type="string">
  Identifiant de l'étude utilisé dans les URL.
</ResponseField>

<ResponseField name="project_id" type="string">
  Identifiant personnalisable défini par l'utilisateur.
</ResponseField>

<ResponseField name="status" type="string">
  Statut de l'étude. Valeurs possibles :

  * `draft` : création de l'étude en cours.
  * `pending` : vérification avant l'ouverture du terrain (soft launch possible).
  * `fieldwork` : terrain de l'étude en cours.
  * `deviating_from_specs` : terrain en pause en raison d'écarts avec les spécifications de la commande d'échantillon.
  * `data_processing` : traitement en cours sur l'étude.
  * `complete` : étude terminée.
  * `user_demo` : étude à usage de démonstration uniquement.
</ResponseField>

<ResponseField name="owner_organization_id" type="integer">
  ID de l'organisation propriétaire de l'enregistrement.
</ResponseField>

<ResponseField name="transition_style" type="string">
  Mode d'affichage du questionnaire utilisé par l'étude. Valeurs possibles :

  * `single_page` : page unique — la nouvelle question apparaît après la réponse à la précédente, comme dans une conversation.
  * `multiple_pages` : pages multiples — la nouvelle question apparaît sur une nouvelle page.
</ResponseField>

<ResponseField name="respondent_questions_count" type="integer">
  Nombre de questions affichées aux répondants dans l'étude.
</ResponseField>

<ResponseField name="respondent_iterations_count" type="integer">
  Nombre d'itérations de questions affichées aux répondants dans l'étude.
</ResponseField>

<Note>
  Une **itération** est une entrée-ligne dans une question de type grille. Par exemple : dans une question grille, chaque ligne est une itération ; dans une question numérique, chaque champ de saisie est une itération ; dans une question à échelle, chaque échelle est une itération.
</Note>

<ResponseExample>
  ```json Réponse 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>