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

# Ouvrir un appel

> Transmettre une panne ou une personne bloquée à l'agence qui entretient l'équipement.

### Endpoint & Authentification

| Méthode | URL |
| :- | :- |
| `POST` | `https://api.arquos.eu/api/partners/calls` |

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

* `Authorization: Bearer [VOTRE_CLE]`
* `Content-Type: application/json`

<Note>
  L'agence est celle de la clé : elle ne se passe pas dans le corps. Voir [Authentification](/v2/authentification).
</Note>

### Paramètres de la requête (Body)

<ParamField body="reference" type="string" required>
  La référence de l'appel chez le centre (120 caractères au plus). La même référence envoyée deux fois rend l'appel déjà ouvert, sans doublon.
</ParamField>

<ParamField body="equipement" type="string" required>
  Le numéro de l'équipement, tel qu'il est au parc de l'agence. Les espaces et la casse sont ignorés.
</ParamField>

<ParamField body="type" type="string" required>
  Valeurs possibles : `personne_bloquee`, `panne`, `vandalisme`, `bruit`.
</ParamField>

<ParamField body="description" type="string" required>
  Ce que l'appelant a signalé, de 3 à 1 000 caractères.
</ParamField>

<ParamField body="appelant" type="string">
  Qui a appelé le centre (120 caractères au plus).
</ParamField>

<ParamField body="recuLe" type="string">
  L'heure de l'appel au centre, au format ISO 8601, dans les vingt-quatre dernières heures. Par défaut, l'heure de réception.
</ParamField>

### Réponse

`201` si l'appel est ouvert, `200` si la référence avait déjà été reçue de ce centre.

<ResponseField name="id" type="string">
  Identifiant de l'appel dans Arquos.
</ResponseField>

<ResponseField name="reference" type="string">
  La référence envoyée.
</ResponseField>

<ResponseField name="statut" type="string">
  Valeurs possibles : `ouverte`, `en_route`, `sur_place`, `a_l_arret`, `resolue`.
</ResponseField>

<ResponseField name="libelle" type="string">
  Le statut en clair, par exemple « Non affecté ».
</ResponseField>

<RequestExample>
  ```bash theme={"system"}
  curl -X POST https://api.arquos.eu/api/partners/calls \
    -H "Authorization: Bearer arq_VOTRE_CLE" \
    -H "Content-Type: application/json" \
    -d '{
      "reference": "CTR-2026-10-08-0042",
      "equipement": "53 A 26936 01",
      "type": "personne_bloquee",
      "description": "Une personne bloquée entre le 3e et le 4e étage.",
      "appelant": "Mme Martin, gardienne"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={"system"}
  { "id": "6f1c…", "reference": "CTR-2026-10-08-0042", "statut": "ouverte", "libelle": "Non affecté" }
  ```
</ResponseExample>

Les refus (`400`, `401`, `404`, `422`, `429`) sont décrits dans [Erreurs](/v2/erreurs).


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