Consultas
Las consultas que ha hecho la gente sobre tus inmuebles, y el estado al que has movido cada una. Acotadas a los inmuebles que posee tu organización: una consulta pertenece a quien posee el inmueble del que trata.
/v1/api/inquiriesinquiries:readListar consultas
Consultas sobre tus inmuebles, de la más nueva a la más antigua.
Paginada por cursor como cualquier otra colección. Filtra por inmueble o por estado para construir una cola de trabajo en lugar de recorrerlo todo.
Parámetros de consulta
| Nombre | Tipo | Descripción |
|---|---|---|
status | enum | Solo las consultas en este estado. new | read | replied | closed | spam ejemplo: new |
property_id | string | Solo las consultas sobre este inmueble. ejemplo: prop_9ad0ddd2e01949ddb471899aba67d577 |
limit | integer | Tamaño de página. Limitado a 200. por defecto: 50ejemplo: 50 |
cursor | string | Cursor opaco del meta.next_cursor de la página anterior. ejemplo: eyJpZCI6InByb3BfMWI3N2UwYTRmMiJ9 |
sort | string | Campo por el que ordenar. Antepón un signo menos para orden descendente. ejemplo: -created_at |
Respuesta
{
"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:readObtener una consulta
Una consulta al completo.
Una consulta sobre un inmueble que tu organización no posee responde exactamente igual que una inexistente, así que la API no se puede usar para tantear fichas que no puedes leer.
Parámetros de ruta
| Nombre | Tipo | Descripción |
|---|---|---|
inquiry_idobligatorio | string | Identificador de la consulta. ejemplo: 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:readMarcar como leída
Deja constancia de que la has visto.
read_at se establece una vez y no se mueve en llamadas posteriores. Responde a cuándo viste la consulta por primera vez, que es lo que le importa a quien espera respuesta; sobrescribirlo respondería a cuándo miraste por última vez, que no lo ha preguntado nadie. Marcar como leída no hará retroceder un estado: una consulta a la que ya has respondido sigue como respondida.
Parámetros de ruta
| Nombre | Tipo | Descripción |
|---|---|---|
inquiry_idobligatorio | string | Identificador de la consulta. ejemplo: 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:readEstablecer el estado
Mueve una consulta por tu flujo de trabajo.
Poner replied registra cuándo ocurrió, y ese registro sobrevive a un paso posterior a cerrada: el hecho de que alguien recibiera respuesta no se deshace por archivar la conversación.
Parámetros de ruta
| Nombre | Tipo | Descripción |
|---|---|---|
inquiry_idobligatorio | string | Identificador de la consulta. ejemplo: inq_db6f3d5316884c649ea1848c278bbf44 |
Campos del cuerpo
| Nombre | Tipo | Descripción |
|---|---|---|
statusobligatorio | string | El estado al que moverla. new | read | replied | closed | spam ejemplo: new |
Cuerpo de la petición
{ "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" }