> ## 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 appels en cours

> Les appels de dépannage non clos : équipement, immeuble, type, statut, heure de réception, technicien.

### Endpoint & Authentification

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

**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 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 d’appels en cours dans vos agences.
</ResponseField>

<ResponseField name="shown" type="integer">
  Le nombre rendu ici (les plus urgents d’abord).
</ResponseField>

<ResponseField name="calls" type="object[]">
  Les appels, les plus urgents d’abord.

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

    <ResponseField name="equipmentId" type="string">
      L’équipement de l’appel. Peut valoir `null`.
    </ResponseField>

    <ResponseField name="number" type="string">
      Le numéro de l’équipement. Peut valoir `null`.
    </ResponseField>

    <ResponseField name="building" type="string">
      Le nom de l’immeuble. Peut valoir `null`.
    </ResponseField>

    <ResponseField name="address" type="string">
      L’adresse de l’immeuble. Peut valoir `null`.
    </ResponseField>

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

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

    <ResponseField name="receivedAt" type="string">
      Quand l’appel a été reçu (ISO 8601). Peut valoir `null`.
    </ResponseField>

    <ResponseField name="caller" type="string">
      Qui a appelé. Peut valoir `null`.
    </ResponseField>

    <ResponseField name="description" type="string">
      Ce que l’appelant a dit. Peut valoir `null`.
    </ResponseField>

    <ResponseField name="technician" type="string">
      Le technicien affecté ; vide s’il n’y en a pas encore. Peut valoir `null`.
    </ResponseField>

    <ResponseField name="stopReason" type="string">
      Pourquoi l’équipement est à l’arrêt, s’il l’est. Peut valoir `null`.
    </ResponseField>

    <ResponseField name="restartExpected" type="string">
      La date de remise en service prévue. Peut valoir `null`.
    </ResponseField>

    <ResponseField name="released" type="boolean">
      Pour une personne bloquée : elle a été libérée.
    </ResponseField>

    <ResponseField name="dueOn" type="string">
      L’heure limite d’intervention (ISO 8601). Peut valoir `null`.
    </ResponseField>

    <ResponseField name="deadlineAt" type="string">
      La fin du délai garanti au contrat (ISO 8601). Peut valoir `null`.
    </ResponseField>

    <ResponseField name="breakdowns30Days" type="integer">
      Le nombre de pannes de l’équipement sur trente jours.
    </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/calls/open \
  --header 'Authorization: Bearer arq_agent_VOTRE_JETON'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"system"}
  {
  "total": 1,
  "shown": 1,
  "calls": [
    {
      "id": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
      "equipmentId": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
      "number": "texte",
      "building": "texte",
      "address": "texte",
      "type": "personne_bloquee",
      "status": "ouverte",
      "receivedAt": "2026-10-10T09:30:00Z",
      "caller": "texte",
      "description": "texte",
      "technician": "texte",
      "stopReason": "texte",
      "restartExpected": "texte",
      "released": true,
      "dueOn": "2026-10-10T09:30:00Z",
      "deadlineAt": "2026-10-10T09:30:00Z",
      "breakdowns30Days": 1,
      "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.