Les données d’un relevé, par composant

curl --request GET \
--url https://api.arquos.eu/api/v2/surveys/ID_DE_L_OBJET/data \
--header 'Authorization: Bearer arq_agent_VOTRE_JETON'

{
"id": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
"number": "texte",
"equipment": {
  "id": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
  "link": "/equipment/3f1c…",
  "url": "https://app.arquos.eu/url"
},
"agency": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
"reason": "texte",
"status": "texte",
"surveyedOn": "2026-10-10",
"link": "/equipment/3f1c…",
"url": "https://app.arquos.eu/url",
"deals": [
  {
    "id": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
    "nature": "texte",
    "natureLabel": "texte",
    "link": "/equipment/3f1c…",
    "url": "https://app.arquos.eu/url"
  }
],
"components": {}
}

curl --request GET \
--url https://api.arquos.eu/api/v2/surveys/ID_DE_L_OBJET/data \
--header 'Authorization: Bearer arq_agent_VOTRE_JETON'

{
"id": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
"number": "texte",
"equipment": {
  "id": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
  "link": "/equipment/3f1c…",
  "url": "https://app.arquos.eu/url"
},
"agency": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
"reason": "texte",
"status": "texte",
"surveyedOn": "2026-10-10",
"link": "/equipment/3f1c…",
"url": "https://app.arquos.eu/url",
"deals": [
  {
    "id": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
    "nature": "texte",
    "natureLabel": "texte",
    "link": "/equipment/3f1c…",
    "url": "https://app.arquos.eu/url"
  }
],
"components": {}
}

Endpoint & Authentification

Méthode	URL
`GET`	`https://api.arquos.eu/api/v2/surveys/{id}/data`

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

required

L’identifiant de l’objet.

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

string

L’identifiant Arquos.

string

Le numéro du relevé. Peut valoir null.

object

L’équipement relevé.

Show Ses champs

string

L’identifiant Arquos.

string

Le chemin de la fiche dans Arquos.

string

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

string

L’agence du relevé.

string

Le motif, tel qu’il se lit. Peut valoir null.

string

Le statut, tel qu’il se lit. Peut valoir null.

string

Le jour du relevé. Au format AAAA-MM-JJ. Peut valoir null.

string

Le chemin de la fiche dans Arquos.

string

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

object[]

Les affaires auxquelles le relevé appartient.

Show Chaque élément

string

L’identifiant Arquos.

string

Le code de la nature de l’affaire. Peut valoir null.

string

La nature, telle qu’elle se lit. Peut valoir null.

string

Le chemin de la fiche dans Arquos.

string

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

object

Les données relevées, rangées par composant (equipment pour l’équipement lui-même, puis car_door, machine, controller…). Une donnée jamais relevée est absente. Chaque donnée : code, libelle, valeur, unite, et champV1 (table et champ de l’API V1, pour qui migre une intégration).

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/surveys/ID_DE_L_OBJET/data \
--header 'Authorization: Bearer arq_agent_VOTRE_JETON'

{
"id": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
"number": "texte",
"equipment": {
  "id": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
  "link": "/equipment/3f1c…",
  "url": "https://app.arquos.eu/url"
},
"agency": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
"reason": "texte",
"status": "texte",
"surveyedOn": "2026-10-10",
"link": "/equipment/3f1c…",
"url": "https://app.arquos.eu/url",
"deals": [
  {
    "id": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
    "nature": "texte",
    "natureLabel": "texte",
    "link": "/equipment/3f1c…",
    "url": "https://app.arquos.eu/url"
  }
],
"components": {}
}

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

Les données d’un relevé, par composant

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