Demandes
Les demandes formulées à propos de vos biens, et l'état dans lequel vous avez placé chacune d'elles. Limitées aux biens que possède votre organisation : une demande appartient à celui qui possède le bien qu'elle concerne.
/v1/api/inquiriesinquiries:readLister les demandes
Demandes portant sur vos biens, de la plus récente à la plus ancienne.
Paginée par curseur comme toutes les autres collections. Filtrez par bien ou par statut pour construire une file de travail plutôt que de tout parcourir.
Paramètres de requête
| Nom | Type | Description |
|---|---|---|
status | enum | Seulement les demandes dans cet état. new | read | replied | closed | spam exemple : new |
property_id | string | Seulement les demandes concernant ce bien. exemple : prop_9ad0ddd2e01949ddb471899aba67d577 |
limit | integer | Taille de page. Plafonnée à 200. par défaut : 50exemple : 50 |
cursor | string | Curseur opaque issu du meta.next_cursor de la page précédente. exemple : eyJpZCI6InByb3BfMWI3N2UwYTRmMiJ9 |
sort | string | Champ de tri. Préfixez d'un moins pour un ordre décroissant. exemple : -created_at |
Réponse
{
"data": [
{
"id": "inq_db6f3d5316884c649ea1848c278bbf44",
"property_id": "prop_f954911b55e14b65b762ee55f01e03b7",
"sender_name": "Anna Schmidt",
"sender_email": "anna@example.com",
"sender_phone": "+49 30 555",
"message": "Is the balcony south facing?",
"status": "new",
"channel": "web",
"consent_text": "I agree to be contacted about this property.",
"consented_at": "2026-08-13T10:43:26Z",
"created_at": "2026-08-13T10:43:26Z"
}
],
"meta": { "has_more": false, "limit": 50 }
}https://api.skautik.com/v1/api/inquiries
GET /v1/api/inquiries?status=new&property_id=prop_9ad0ddd2e01949ddb471899aba67d577&limit=50 HTTP/1.1
Host: api.skautik.com
Authorization: Bearer sk_live_…/v1/api/inquiries/{inquiry_id}inquiries:readRécupérer une demande
Une demande en entier.
Une demande portant sur un bien que votre organisation ne possède pas répond exactement comme une demande inexistante : l'API ne peut donc pas servir à sonder l'existence de fiches que vous ne pouvez pas lire.
Paramètres de chemin
| Nom | Type | Description |
|---|---|---|
inquiry_idobligatoire | string | Identifiant de la demande. exemple : inq_db6f3d5316884c649ea1848c278bbf44 |
https://api.skautik.com/v1/api/inquiries/{inquiry_id}
GET /v1/api/inquiries/inq_db6f3d5316884c649ea1848c278bbf44 HTTP/1.1
Host: api.skautik.com
Authorization: Bearer sk_live_…/v1/api/inquiries/{inquiry_id}/readinquiries:readMarquer comme lue
Consignez que vous l'avez vue.
read_at est défini une fois et ne bouge pas aux appels suivants. Il répond à la question de savoir quand vous avez vu la demande pour la première fois, ce qui intéresse la personne qui attend une réponse ; l'écraser répondrait à quand vous avez regardé la dernière fois, ce que personne n'a demandé. Marquer comme lue ne fera pas reculer un statut : une demande à laquelle vous avez déjà répondu reste répondue.
Paramètres de chemin
| Nom | Type | Description |
|---|---|---|
inquiry_idobligatoire | string | Identifiant de la demande. exemple : inq_db6f3d5316884c649ea1848c278bbf44 |
https://api.skautik.com/v1/api/inquiries/{inquiry_id}/read
POST /v1/api/inquiries/inq_db6f3d5316884c649ea1848c278bbf44/read HTTP/1.1
Host: api.skautik.com
Authorization: Bearer sk_live_…/v1/api/inquiries/{inquiry_id}inquiries:readDéfinir le statut
Faites avancer une demande dans votre flux de travail.
Passer à replied consigne le moment où cela s'est produit, et ce constat survit à un passage ultérieur en clos : le fait que quelqu'un ait reçu une réponse n'est pas annulé par le classement de la conversation.
Paramètres de chemin
| Nom | Type | Description |
|---|---|---|
inquiry_idobligatoire | string | Identifiant de la demande. exemple : inq_db6f3d5316884c649ea1848c278bbf44 |
Champs du corps
| Nom | Type | Description |
|---|---|---|
statusobligatoire | string | L'état vers lequel la déplacer. new | read | replied | closed | spam exemple : new |
Corps de la requête
{ "status": "replied" }https://api.skautik.com/v1/api/inquiries/{inquiry_id}
PATCH /v1/api/inquiries/inq_db6f3d5316884c649ea1848c278bbf44 HTTP/1.1
Host: api.skautik.com
Authorization: Bearer sk_live_…
Content-Type: application/json
{ "status": "replied" }