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

# Lister les écarts et les réserves

> Les plus récents d’abord : constat, composant, action décidée, statut, gravité, échéance et levée.

### Endpoint & Authentification

| Méthode | URL |
| :- | :- |
| `GET` | `https://api.arquos.eu/api/v2/discrepancies` |

**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 query="equipment" type="string">
  L’identifiant de l’équipement.
</ParamField>

<ParamField query="status" type="string">
  Le statut de l’écart.
</ParamField>

<ParamField query="since" type="string">
  Créés à partir de ce jour, AAAA-MM-JJ.
</ParamField>

<ParamField query="until" type="string">
  Créés jusqu’à ce jour inclus, AAAA-MM-JJ.
</ParamField>

<ParamField query="limit" type="integer">
  Combien de lignes, 50 par défaut, 200 au plus.
</ParamField>

<ParamField query="page" type="integer">
  La page, à partir de 1.
</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="total" type="integer">
  Le nombre de lignes qui répondent, toutes pages confondues.
</ResponseField>

<ResponseField name="page" type="integer">
  La page rendue, à partir de 1.
</ResponseField>

<ResponseField name="limit" type="integer">
  Le nombre de lignes par page (50 par défaut, 200 au plus).
</ResponseField>

<ResponseField name="results" type="object[]">
  Les lignes de la page.

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

    <ResponseField name="equipment" type="string">
      L’équipement concerné. Peut valoir `null`.
    </ResponseField>

    <ResponseField name="survey" type="string">
      Le relevé où l’écart a été constaté, s’il vient d’un relevé. Peut valoir `null`.
    </ResponseField>

    <ResponseField name="component" type="string">
      Le composant en cause (`car_door`, `machine`…), ou `null`. Peut valoir `null`.
    </ResponseField>

    <ResponseField name="finding" type="string">
      Ce qui a été constaté. Peut valoir `null`.
    </ResponseField>

    <ResponseField name="action" type="string">
      L’action décidée (une des actions de l’agence, ou un texte libre), ou `null` tant que l’écart n’est pas qualifié. Peut valoir `null`.
    </ResponseField>

    <ResponseField name="status" type="string">
      `ouvert` ou `resolu`. Peut valoir `null`.
    </ResponseField>

    <ResponseField name="severity" type="string">
      Pour une réserve de contrôle technique : `danger_grave` (7 jours), `a_corriger` (90 jours) ou `observation` (365 jours). Peut valoir `null`.
    </ResponseField>

    <ResponseField name="origin" type="string">
      D’où vient l’écart : un relevé, un contrôle technique (une réserve), un technicien, une réception. Valeurs possibles : `releve`, `controle`, `technicien`, `reception`. Peut valoir `null`.
    </ResponseField>

    <ResponseField name="dueOn" type="string">
      La date limite pour le lever. Au format AAAA-MM-JJ. Peut valoir `null`.
    </ResponseField>

    <ResponseField name="liftedOn" type="string">
      Le jour où il a été levé. Au format AAAA-MM-JJ. Peut valoir `null`.
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      Le jour de sa création. 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>
  </Expandable>
</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/discrepancies \
  --header 'Authorization: Bearer arq_agent_VOTRE_JETON'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"system"}
  {
  "total": 1,
  "page": 1,
  "limit": 1,
  "results": [
    {
      "id": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
      "equipment": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
      "survey": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
      "component": "texte",
      "finding": "texte",
      "action": "texte",
      "status": "ouvert",
      "severity": "danger_grave",
      "origin": "releve",
      "dueOn": "2026-10-10",
      "liftedOn": "2026-10-10",
      "createdAt": "2026-10-10",
      "link": "/equipment/3f1c…",
      "url": "https://app.arquos.eu/url"
    }
  ]
  }
  ```
</ResponseExample>


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