Créer un relevé Arquos

{
  "agency_id": "test_agency_01",
  "type_affaire": "",
  "solliciteur_email": "test+202244@arquos.eu",
  "releveur_email": "test+028910@arquos.eu",
  "type_etat_des_lieux": ["Prise en mains", "Essais"],
  "external_opportunity_id": "OPP-2026-00042",
  "equipments": [
    {
      "equipment_number": "ASC_45678",
      "adresse": "29 Rue Bontemps, 33400 Talence, France",
      "complement_adresse": "BAT A",
      "consignes_acces": ["Digicode", "Autre"],
      "consignes_acces_autre": "Sonner à l'interphone 'Gardien'",
      "digicode": "A123",
      "client_id": "CLI-882",
      "client_nom": "ImmoGestion Sud",
      "client_telephone": "0123456789"
    },
    {
      "equipment_number": "ASC_89023",
      "adresse": "29 Rue Bontemps, 33400 Talence, France",
      "complement_adresse": "BAT B",
      "consignes_acces": ["Digicode", "Autre"],
      "consignes_acces_autre": "Sonner à l'interphone 'Gardien'",
      "digicode": "A123",
      "client_id": "CLI-882",
      "client_nom": "ImmoGestion Sud",
      "client_telephone": "0123456789"
    }
  ]
}

curl --request POST \
  --url https://app.arquos.eu/api/1.1/wf/create_survey \
  --header 'x-api-key: VOTRE_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "agency_id": "test_agency_01",
  "type_affaire": "",
  "solliciteur_email": "test+202244@arquos.eu",
  "releveur_email": "test+028910@arquos.eu",
  "type_etat_des_lieux": ["Prise en mains", "Essais"],
  "external_opportunity_id": "OPP-2026-00042",
  "equipments": [
    {
      "equipment_number": "ASC_45678",
      "adresse": "29 Rue Bontemps, 33400 Talence, France",
      "complement_adresse": "BAT A",
      "consignes_acces": ["Digicode", "Autre"],
      "consignes_acces_autre": "Sonner à l'interphone 'Gardien'",
      "digicode": "A123",
      "client_id": "CLI-882",
      "client_nom": "ImmoGestion Sud",
      "client_telephone": "0123456789"
    },
    {
      "equipment_number": "ASC_89023",
      "adresse": "29 Rue Bontemps, 33400 Talence, France",
      "complement_adresse": "BAT B",
      "consignes_acces": ["Digicode", "Autre"],
      "consignes_acces_autre": "Sonner à l'interphone 'Gardien'",
      "digicode": "A123",
      "client_id": "CLI-882",
      "client_nom": "ImmoGestion Sud",
      "client_telephone": "0123456789"
    }
  ]
}'

{
  "status": "success",
  "response": {
    "id_affaire": "1784193778642x782286771798901300"
  }
}

Endpoint & Authentification

Méthode	URL
`POST`	`https://app.arquos.eu/api/1.1/wf/create_survey`

En-têtes (Headers) :

x-api-key: [VOTRE_API_KEY]

La clé API est propre à chaque partenaire et n’est autorisée que sur les agences qui lui ont été attribuées. Un appel avec une clé invalide, ou visant une agence non autorisée, n’est pas exécuté (le relevé n’est pas créé).

Paramètres de la requête (Body)

string

required

Identifiant unique de l’agence.

string

Requis si type_etat_des_lieux est vide.Valeurs : Contrat, Réparation, Modernisation pour devis, Remplacement complet pour devis, Modernisation pour commande ou Remplacement complet pour commande.

array

Requis si type_affaire est vide.Valeurs possibles : Prise en mains, Essais, Base parc.

string

required

Email de l’initiateur de la demande.

string

required

Email du technicien affecté.

object[]

required

Liste des équipements concernés par le relevé.

Hide Détails de l'objet équipement

string

required

Numéro unique de l’appareil.

string

required

Adresse de l’immeuble.

string

Bâtiment, étage, etc.

array

Valeurs possibles : Sans, Digicode, Coffre à clé, Vigik ou Autre.

string

Précisions si Autre est sélectionné.

string

Code d’entrée.

string

Emplacement des clés.

string

ID interne du client gestionnaire.

string

Nom du client gestionnaire.

string

Numéro de téléphone du client gestionnaire.

string

Adresse postale du client gestionnaire.

string

Numéro SIRET du client gestionnaire.

string

Numéro SIREN du client gestionnaire.

{
  "agency_id": "test_agency_01",
  "type_affaire": "",
  "solliciteur_email": "test+202244@arquos.eu",
  "releveur_email": "test+028910@arquos.eu",
  "type_etat_des_lieux": ["Prise en mains", "Essais"],
  "external_opportunity_id": "OPP-2026-00042",
  "equipments": [
    {
      "equipment_number": "ASC_45678",
      "adresse": "29 Rue Bontemps, 33400 Talence, France",
      "complement_adresse": "BAT A",
      "consignes_acces": ["Digicode", "Autre"],
      "consignes_acces_autre": "Sonner à l'interphone 'Gardien'",
      "digicode": "A123",
      "client_id": "CLI-882",
      "client_nom": "ImmoGestion Sud",
      "client_telephone": "0123456789"
    },
    {
      "equipment_number": "ASC_89023",
      "adresse": "29 Rue Bontemps, 33400 Talence, France",
      "complement_adresse": "BAT B",
      "consignes_acces": ["Digicode", "Autre"],
      "consignes_acces_autre": "Sonner à l'interphone 'Gardien'",
      "digicode": "A123",
      "client_id": "CLI-882",
      "client_nom": "ImmoGestion Sud",
      "client_telephone": "0123456789"
    }
  ]
}

curl --request POST \
  --url https://app.arquos.eu/api/1.1/wf/create_survey \
  --header 'x-api-key: VOTRE_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "agency_id": "test_agency_01",
  "type_affaire": "",
  "solliciteur_email": "test+202244@arquos.eu",
  "releveur_email": "test+028910@arquos.eu",
  "type_etat_des_lieux": ["Prise en mains", "Essais"],
  "external_opportunity_id": "OPP-2026-00042",
  "equipments": [
    {
      "equipment_number": "ASC_45678",
      "adresse": "29 Rue Bontemps, 33400 Talence, France",
      "complement_adresse": "BAT A",
      "consignes_acces": ["Digicode", "Autre"],
      "consignes_acces_autre": "Sonner à l'interphone 'Gardien'",
      "digicode": "A123",
      "client_id": "CLI-882",
      "client_nom": "ImmoGestion Sud",
      "client_telephone": "0123456789"
    },
    {
      "equipment_number": "ASC_89023",
      "adresse": "29 Rue Bontemps, 33400 Talence, France",
      "complement_adresse": "BAT B",
      "consignes_acces": ["Digicode", "Autre"],
      "consignes_acces_autre": "Sonner à l'interphone 'Gardien'",
      "digicode": "A123",
      "client_id": "CLI-882",
      "client_nom": "ImmoGestion Sud",
      "client_telephone": "0123456789"
    }
  ]
}'

{
  "status": "success",
  "response": {
    "id_affaire": "1784193778642x782286771798901300"
  }
}

Relevé

Fiche équipement

Données équipements

Données clients

Statistiques

Données de référence

Endpoint & Authentification

Paramètres de la requête (Body)

​Endpoint & Authentification

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

Endpoint & Authentification

Paramètres de la requête (Body)