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

# La maintenance d’un équipement

> Son contrat, son plan de maintenance (dû, en retard), son carnet d’entretien récent, ses appels et ses réserves.

### Endpoint & Authentification

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

**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="maintained" type="boolean">
  L’équipement est au parc entretenu par l’agence.
</ResponseField>

<ResponseField name="pairedReason" type="string">
  Pourquoi une intervention y demande deux techniciens, ou `null`. Peut valoir `null`.
</ResponseField>

<ResponseField name="state" type="string">
  Son état en ce moment. Valeurs possibles : `en_service`, `en_panne`, `a_l_arret`.
</ResponseField>

<ResponseField name="call" type="object">
  L’appel en cours, ou `null`. Peut valoir `null`.

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

    <ResponseField name="type" type="string">
      Le motif de l’appel. Valeurs possibles : `personne_bloquee`, `panne`, `vandalisme`, `bruit`, `arret_client`, `telealarme`.
    </ResponseField>

    <ResponseField name="status" type="string">
      Où en est l’intervention. Valeurs possibles : `ouverte`, `en_route`, `sur_place`, `resolue`, `a_l_arret`.
    </ResponseField>

    <ResponseField name="receivedAt" type="string">
      Quand l’appel a été reçu.
    </ResponseField>

    <ResponseField name="detail" type="string">
      Le motif d’arrêt ou ce que l’appelant a dit. Peut valoir `null`.
    </ResponseField>

    <ResponseField name="restartPlannedOn" type="string">
      La remise en service prévue. Au format AAAA-MM-JJ. Peut valoir `null`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="lastMaintenanceVisit" type="string">
  La dernière visite d’entretien faite. Au format AAAA-MM-JJ. Peut valoir `null`.
</ResponseField>

<ResponseField name="deadline" type="string">
  La date à laquelle la prochaine visite est due. Au format AAAA-MM-JJ. Peut valoir `null`.
</ResponseField>

<ResponseField name="next" type="object">
  La prochaine visite planifiée, ou `null`. Peut valoir `null`.

  <Expandable title="Ses champs">
    <ResponseField name="day" type="string">
      Le jour planifié, AAAA-MM-JJ.
    </ResponseField>

    <ResponseField name="technician" type="string">
      Le technicien planifié. Peut valoir `null`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="sectorTechnician" type="string">
  Le technicien du secteur de l’équipement. Peut valoir `null`.
</ResponseField>

<ResponseField name="contract" type="object">
  Le contrat d’entretien, ou `null`. Peut valoir `null`.

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

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

    <ResponseField name="plan" type="string">
      Sa formule. Valeurs possibles : `minimal`, `etendu`. Peut valoir `null`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="breakdowns30Days" type="integer">
  Les pannes sur trente jours (hors bruit et arrêt demandé).
</ResponseField>

<ResponseField name="breakdowns12Months" type="integer">
  Les pannes sur douze mois.
</ResponseField>

<ResponseField name="logbook" type="object[]">
  Le carnet d’entretien récent.
</ResponseField>

<ResponseField name="totalVisits" type="integer">
  Le nombre de passages au carnet.
</ResponseField>

<ResponseField name="inspection" type="object">
  Le dernier contrôle technique : sa date, l’organisme, et ses réserves. Peut valoir `null`.
</ResponseField>

<ResponseField name="announcedInspection" type="object">
  Le prochain contrôle annoncé, et les techniciens qui peuvent l’accompagner. Peut valoir `null`.
</ResponseField>

<ResponseField name="technicians" type="object[]">
  Les techniciens de l’agence, pour planifier ou affecter.

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

    <ResponseField name="name" type="string">
      Son nom.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="reserves" type="object[]">
  Les réserves ouvertes.
</ResponseField>

<ResponseField name="emergencyPhone" type="object">
  La téléalarme de la cabine : son opérateur, son dernier essai, son état. Peut valoir `null`.
</ResponseField>

<ResponseField name="quotes" type="object[]">
  Les devis de l’équipement.
</ResponseField>

<ResponseField name="partRequests" type="object[]">
  Les pièces demandées ou commandées.
</ResponseField>

<ResponseField name="availability" type="object">
  La disponibilité, celle du rapport ; `null` hors du parc suivi. Peut valoir `null`.

  <Expandable title="Ses champs">
    <ResponseField name="rate" type="number">
      Le taux de disponibilité sur douze mois, en pourcentage.
    </ResponseField>

    <ResponseField name="downtimeHours" type="number">
      Les heures d’arrêt sur douze mois.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="maintenancePlan" type="object[]">
  Le plan de maintenance de l’équipement.
</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/equipment/ID_DE_L_OBJET/maintenance \
  --header 'Authorization: Bearer arq_agent_VOTRE_JETON'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"system"}
  {
  "maintained": true,
  "pairedReason": "texte",
  "state": "en_service",
  "call": {
    "id": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
    "type": "personne_bloquee",
    "status": "ouverte",
    "receivedAt": "2026-10-10T09:30:00Z",
    "detail": "texte",
    "restartPlannedOn": "2026-10-10"
  },
  "lastMaintenanceVisit": "2026-10-10",
  "deadline": "2026-10-10",
  "next": {
    "day": "2026-10-10",
    "technician": "texte"
  },
  "sectorTechnician": "texte",
  "contract": {
    "id": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
    "number": "texte",
    "plan": "minimal"
  },
  "breakdowns30Days": 1,
  "breakdowns12Months": 1,
  "logbook": [
    {}
  ],
  "totalVisits": 1,
  "inspection": {},
  "announcedInspection": {},
  "technicians": [
    {
      "id": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
      "name": "texte"
    }
  ],
  "reserves": [
    {}
  ],
  "emergencyPhone": {},
  "quotes": [
    {}
  ],
  "partRequests": [
    {}
  ],
  "availability": {
    "rate": 12.5,
    "downtimeHours": 12.5
  },
  "maintenancePlan": [
    {}
  ]
  }
  ```
</ResponseExample>


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