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

# Les données d’un relevé, par composant

> Le relevé, son équipement, et les données relevées de l’équipement rangées par composant (porte cabine, machine, armoire…). Une donnée jamais relevée est absente. Chaque donnée dit aussi son nom dans l’API V1 (champV1 : table et champ), pour qui migre une intégration.

### Endpoint & Authentification

| Méthode | URL |
| :- | :- |
| `GET` | `https://api.arquos.eu/api/v2/surveys/{id}/data` |

**En-têtes (Headers) :**

* `Authorization: Bearer [VOTRE_JETON_D_API]`
* `X-Arquos-Agency: [IDENTIFIANT_D_AGENCE]` (facultatif, voir [Agence](/v2/agence))

### Paramètres de la requête

<ParamField path="id" type="string" required>
  L’identifiant de l’objet.
</ParamField>

<ParamField header="X-Arquos-Agency" type="string">
  L’identifiant de l’agence où agir. Absent : l’agence par défaut du compte. Une agence hors de sa portée est refusée (403).
</ParamField>

### Réponse (`200`)

<ResponseField name="id" type="string">
  L’identifiant Arquos.
</ResponseField>

<ResponseField name="number" type="string">
  Le numéro du relevé. Peut valoir `null`.
</ResponseField>

<ResponseField name="equipment" type="object">
  L’équipement relevé.

  <Expandable title="Ses champs">
    <ResponseField name="id" type="string">
      L’identifiant Arquos.
    </ResponseField>

    <ResponseField name="link" type="string">
      Le chemin de la fiche dans Arquos.
    </ResponseField>

    <ResponseField name="url" type="string">
      L’adresse complète de la fiche, à ouvrir dans un navigateur.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="agency" type="string">
  L’agence du relevé.
</ResponseField>

<ResponseField name="reason" type="string">
  Le motif, tel qu’il se lit. Peut valoir `null`.
</ResponseField>

<ResponseField name="status" type="string">
  Le statut, tel qu’il se lit. Peut valoir `null`.
</ResponseField>

<ResponseField name="surveyedOn" type="string">
  Le jour du relevé. Au format AAAA-MM-JJ. Peut valoir `null`.
</ResponseField>

<ResponseField name="link" type="string">
  Le chemin de la fiche dans Arquos.
</ResponseField>

<ResponseField name="url" type="string">
  L’adresse complète de la fiche, à ouvrir dans un navigateur.
</ResponseField>

<ResponseField name="deals" type="object[]">
  Les affaires auxquelles le relevé appartient.

  <Expandable title="Chaque élément">
    <ResponseField name="id" type="string">
      L’identifiant Arquos.
    </ResponseField>

    <ResponseField name="nature" type="string">
      Le code de la nature de l’affaire. Peut valoir `null`.
    </ResponseField>

    <ResponseField name="natureLabel" type="string">
      La nature, telle qu’elle se lit. Peut valoir `null`.
    </ResponseField>

    <ResponseField name="link" type="string">
      Le chemin de la fiche dans Arquos.
    </ResponseField>

    <ResponseField name="url" type="string">
      L’adresse complète de la fiche, à ouvrir dans un navigateur.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="components" type="object">
  Les données relevées, rangées par composant (`equipment` pour l’équipement lui-même, puis `car_door`, `machine`, `controller`…). Une donnée jamais relevée est absente. Chaque donnée : `code`, `libelle`, `valeur`, `unite`, et `champV1` (`table` et `champ` de l’API V1, pour qui migre une intégration).
</ResponseField>

### Les erreurs

| Code | Quand |
| :- | :- |
| `400` | Requête mal formée ou champ obligatoire manquant. |
| `401` | Jeton absent, inconnu ou révoqué. |
| `403` | Agence hors de votre portée. |
| `404` | Objet introuvable dans vos agences. |
| `429` | Trop d’appels : réessayez après le délai de l’en-tête Retry-After. |

Le corps d'une erreur porte `error`, sa raison en français. Voir [Les erreurs](/v2/erreurs).

<RequestExample>
  ```bash cURL theme={"system"}
  curl --request GET \
  --url https://api.arquos.eu/api/v2/surveys/ID_DE_L_OBJET/data \
  --header 'Authorization: Bearer arq_agent_VOTRE_JETON'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"system"}
  {
  "id": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
  "number": "texte",
  "equipment": {
    "id": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
    "link": "/equipment/3f1c…",
    "url": "https://app.arquos.eu/url"
  },
  "agency": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
  "reason": "texte",
  "status": "texte",
  "surveyedOn": "2026-10-10",
  "link": "/equipment/3f1c…",
  "url": "https://app.arquos.eu/url",
  "deals": [
    {
      "id": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
      "nature": "texte",
      "natureLabel": "texte",
      "link": "/equipment/3f1c…",
      "url": "https://app.arquos.eu/url"
    }
  ],
  "components": {}
  }
  ```
</ResponseExample>


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