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

# Suivi de terrain

> Consulter les indicateurs de suivi de terrain d'une étude.

## Consulter le suivi de terrain

Renvoie les indicateurs de progression du terrain pour une étude.

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

### Paramètres

<ParamField path="SURVEY_ID" type="integer" required>
  L'identifiant de l'étude.
</ParamField>

<ParamField query="sample_source_id" type="integer">
  Identifiant d'une source d'échantillon de l'étude courante, pour filtrer les indicateurs sur cette source.
</ParamField>

### Champs de réponse

<ResponseField name="sample_size" type="integer">
  Nombre d'interviews complètes attendues.
</ResponseField>

<ResponseField name="interviews_count" type="integer">
  Nombre d'interviews complètes collectées.
</ResponseField>

<ResponseField name="interview_count_by_status" type="object">
  Nombre d'interviews par statut.

  <Expandable title="détail par statut">
    Chaque statut contient un nombre d'individus (`individuals`) et un pourcentage (`percentage`) : `complete`, `incomplete`, `quota_full`, `screen_out`, `above_target`, `manual_action`, `pending_analysis`, `speeder`, `straightliner`, `failed_quality_check`, `inappropriate_language`.
  </Expandable>
</ResponseField>

<ResponseField name="completion_rate" type="float">
  Nombre d'interviews complètes divisé par la taille totale de l'échantillon.
</ResponseField>

<ResponseField name="questionnaire_incidence_rate" type="float">
  Nombre d'interviews complètes divisé par le nombre d'interviews complètes + screen out + quota-full + incomplètes.
</ResponseField>

<ResponseField name="target_incidence_rate" type="float">
  Nombre d'interviews complètes divisé par le nombre d'interviews complètes + screen out.
</ResponseField>

<ResponseField name="incidence_rate" type="float" deprecated>
  Nombre d'interviews complètes divisé par le nombre d'interviews complètes + screen out.

  <Warning>
    Cet indicateur est **déprécié** et sera retiré dans une version future. Il est remplacé par `target_incidence_rate`.
  </Warning>
</ResponseField>

<ResponseField name="drop_out_rate" type="float">
  Nombre d'interviews incomplètes divisé par le nombre total d'interviews.
</ResponseField>

<ResponseField name="length_of_interview" type="integer">
  Durée médiane d'une interview complète, en secondes.
</ResponseField>

<ResponseExample>
  ```json Réponse theme={null}
  {
    "fieldwork_progress": {
      "sample_size": 100,
      "interviews_count": 3,
      "interview_count_by_status": {
        "complete": { "individuals": 3, "percentage": 0.125 },
        "incomplete": { "individuals": 3, "percentage": 0.125 },
        "quota_full": { "individuals": 3, "percentage": 0.125 },
        "screen_out": { "individuals": 3, "percentage": 0.125 },
        "above_target": { "individuals": 0, "percentage": 0.0 },
        "manual_action": { "individuals": 0, "percentage": 0.0 },
        "pending_analysis": { "individuals": 0, "percentage": 0.0 },
        "speeder": { "individuals": 3, "percentage": 0.125 },
        "straightliner": { "individuals": 3, "percentage": 0.125 },
        "failed_quality_check": { "individuals": 3, "percentage": 0.125 },
        "inappropriate_language": { "individuals": 3, "percentage": 0.125 }
      },
      "completion_rate": 0.03,
      "questionnaire_incidence_rate": 0.25,
      "target_incidence_rate": 0.5,
      "incidence_rate": 0.5,
      "drop_out_rate": 0.125,
      "length_of_interview": 300
    }
  }
  ```
</ResponseExample>