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

# Lire un appel

> Les informations déclarées de la fiche, par identifiant d’attribut, et son lien.

### Endpoint & Authentification

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

**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="type" type="string">
  Le type de l’objet, au singulier.
</ResponseField>

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

<ResponseField name="fields" type="object">
  Les informations de la fiche, par identifiant d’attribut. Toutes sont présentes ; une information non renseignée vaut `null`.

  <Expandable title="Ses champs">
    <ResponseField name="kind" type="string">
      Type. Valeurs possibles : `personne_bloquee` (Personne bloquée), `panne` (Panne), `vandalisme` (Vandalisme), `bruit` (Bruit ou gêne), `arret_client` (Arrêt demandé), `telealarme` (Téléalarme en défaut). Peut valoir `null`.
    </ResponseField>

    <ResponseField name="description" type="string">
      Ce qui est signalé. Un texte. Peut valoir `null`.
    </ResponseField>

    <ResponseField name="caller" type="string">
      Appelant. Un texte. Peut valoir `null`.
    </ResponseField>

    <ResponseField name="receivedAt" type="string">
      Reçu le. Une date et une heure, au format JJ/MM/AAAA HH:MM. Peut valoir `null`.
    </ResponseField>

    <ResponseField name="status" type="string">
      Statut. Valeurs possibles : `ouverte` (Non affecté), `en_route` (En route), `sur_place` (Sur place), `a_l_arret` (À l’arrêt), `resolue` (Résolu). Peut valoir `null`.
    </ResponseField>

    <ResponseField name="dispatchedAt" type="string">
      Pris en charge à. Une date et une heure, au format JJ/MM/AAAA HH:MM. Peut valoir `null`.
    </ResponseField>

    <ResponseField name="arrivedAt" type="string">
      Arrivée sur place. Une date et une heure, au format JJ/MM/AAAA HH:MM. Peut valoir `null`.
    </ResponseField>

    <ResponseField name="releasedAt" type="string">
      Personne libérée à. Une date et une heure, au format JJ/MM/AAAA HH:MM. Peut valoir `null`.
    </ResponseField>

    <ResponseField name="resolvedAt" type="string">
      Remis en service le. Une date et une heure, au format JJ/MM/AAAA HH:MM. Peut valoir `null`.
    </ResponseField>

    <ResponseField name="cause" type="string">
      Cause. Un texte. Peut valoir `null`.
    </ResponseField>

    <ResponseField name="component" type="string">
      Composant. Un texte. Peut valoir `null`.
    </ResponseField>

    <ResponseField name="workDone" type="string">
      Travaux réalisés. Un texte. Peut valoir `null`.
    </ResponseField>

    <ResponseField name="signedBy" type="string">
      Signé par. Un texte. Peut valoir `null`.
    </ResponseField>

    <ResponseField name="stoppedReason" type="string">
      Motif de l’arrêt. Un texte. Peut valoir `null`.
    </ResponseField>

    <ResponseField name="restartExpected" type="string">
      Remise en service prévue. Une date, au format JJ/MM/AAAA. Peut valoir `null`.
    </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/ID_DE_L_OBJET \
  --header 'Authorization: Bearer arq_agent_VOTRE_JETON'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"system"}
  {
  "type": "appel",
  "id": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
  "link": "/equipment/3f1c…",
  "url": "https://app.arquos.eu/url",
  "fields": {
    "kind": "texte",
    "description": "texte",
    "caller": "texte",
    "receivedAt": "texte",
    "status": "texte",
    "dispatchedAt": "texte",
    "arrivedAt": "texte",
    "releasedAt": "texte",
    "resolvedAt": "texte",
    "cause": "texte",
    "component": "texte",
    "workDone": "texte",
    "signedBy": "texte",
    "stoppedReason": "texte",
    "restartExpected": "texte"
  }
  }
  ```
</ResponseExample>


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