Les appels en cours

curl --request GET \
--url https://api.arquos.eu/api/v2/calls/open \
--header 'Authorization: Bearer arq_agent_VOTRE_JETON'

{
"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"
  }
]
}

curl --request GET \
--url https://api.arquos.eu/api/v2/calls/open \
--header 'Authorization: Bearer arq_agent_VOTRE_JETON'

{
"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"
  }
]
}

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)

Paramètres de la requête

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

Réponse (`200`)

integer

Le nombre d’appels en cours dans vos agences.

integer

Le nombre rendu ici (les plus urgents d’abord).

object[]

Les appels, les plus urgents d’abord.

Show Chaque élément

string

L’identifiant Arquos.

string

L’équipement de l’appel. Peut valoir null.

string

Le numéro de l’équipement. Peut valoir null.

string

Le nom de l’immeuble. Peut valoir null.

string

L’adresse de l’immeuble. Peut valoir null.

string

Le motif de l’appel. Valeurs possibles : personne_bloquee, panne, vandalisme, bruit, arret_client, telealarme. Peut valoir null.

string

Où en est l’intervention. Valeurs possibles : ouverte, en_route, sur_place, resolue, a_l_arret. Peut valoir null.

string

Quand l’appel a été reçu (ISO 8601). Peut valoir null.

string

Qui a appelé. Peut valoir null.

string

Ce que l’appelant a dit. Peut valoir null.

string

Le technicien affecté ; vide s’il n’y en a pas encore. Peut valoir null.

string

Pourquoi l’équipement est à l’arrêt, s’il l’est. Peut valoir null.

string

La date de remise en service prévue. Peut valoir null.

boolean

Pour une personne bloquée : elle a été libérée.

string

L’heure limite d’intervention (ISO 8601). Peut valoir null.

string

La fin du délai garanti au contrat (ISO 8601). Peut valoir null.

integer

Le nombre de pannes de l’équipement sur trente jours.

string

Le chemin de la fiche dans Arquos.

string

L’adresse complète de la fiche, à ouvrir dans un navigateur.

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.

curl --request GET \
--url https://api.arquos.eu/api/v2/calls/open \
--header 'Authorization: Bearer arq_agent_VOTRE_JETON'

{
"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"
  }
]
}

Démarrer

API REST

Centres d'appels

Agents IA

Référence · Compte

Référence · Recherche

Référence · Équipements

Référence · Relevés

Référence · Contrats

Référence · Import

Référence · Webhooks

Référence · Référentiels

Référence · Affaires

Référence · Appels

Référence · Visites

Référence · Techniciens

Référence · Pièces

Référence · Devis

Référence · Notes

Référence · Écarts et réserves

Référence · Factures

Référence · Clients

Référence · Immeubles

Référence · Contacts

Référence · Secteurs

Référence · Campagnes

Référence · Contrôles techniques

Référence · Sollicitations

Endpoint & Authentification

Paramètres de la requête

Réponse (`200`)

Les erreurs

​Endpoint & Authentification

​Paramètres de la requête

​Réponse (200)

​Les erreurs

Endpoint & Authentification

Paramètres de la requête

Réponse (`200`)

Les erreurs