Anfragen
Anfragen, die Menschen zu Ihren Objekten gestellt haben, und der Zustand, in den Sie jede versetzt haben. Beschränkt auf die Objekte Ihrer Organisation: Eine Anfrage gehört dem, dem das Objekt gehört, um das es geht.
/v1/api/inquiriesinquiries:readAnfragen auflisten
Anfragen zu Ihren Objekten, neueste zuerst.
Über Cursor geblättert wie jede andere Sammlung. Nach Objekt oder Status filtern, um eine Arbeitsliste zu bauen, statt alles durchzublättern.
Query-Parameter
| Name | Typ | Beschreibung |
|---|---|---|
status | enum | Nur Anfragen in diesem Zustand. new | read | replied | closed | spam Beispiel: new |
property_id | string | Nur Anfragen zu diesem Objekt. Beispiel: prop_9ad0ddd2e01949ddb471899aba67d577 |
limit | integer | Seitengröße. Auf 200 begrenzt. Vorgabe: 50Beispiel: 50 |
cursor | string | Undurchsichtiger Cursor aus meta.next_cursor der vorherigen Seite. Beispiel: eyJpZCI6InByb3BfMWI3N2UwYTRmMiJ9 |
sort | string | Feld, nach dem sortiert wird. Mit einem Minus davor absteigend. Beispiel: -created_at |
Antwort
{
"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:readEine Anfrage abrufen
Eine Anfrage vollständig.
Eine Anfrage zu einem Objekt, das Ihrer Organisation nicht gehört, wird genauso beantwortet wie eine, die es nicht gibt, die API lässt sich also nicht nutzen, um nach Datensätzen zu suchen, die Sie nicht lesen dürfen.
Pfadparameter
| Name | Typ | Beschreibung |
|---|---|---|
inquiry_iderforderlich | string | Anfragekennung. Beispiel: 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:readAls gelesen markieren
Festhalten, dass Sie sie gesehen haben.
read_at wird einmal gesetzt und bewegt sich bei späteren Aufrufen nicht. Es beantwortet, wann Sie die Anfrage zuerst gesehen haben, und das ist es, was die wartende Person interessiert; es zu überschreiben würde beantworten, wann Sie zuletzt nachgesehen haben, wonach niemand gefragt hat. Als gelesen zu markieren zieht einen Status nicht zurück: Eine bereits beantwortete Anfrage bleibt beantwortet.
Pfadparameter
| Name | Typ | Beschreibung |
|---|---|---|
inquiry_iderforderlich | string | Anfragekennung. Beispiel: 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:readDen Status setzen
Eine Anfrage durch Ihren Arbeitsablauf bewegen.
replied zu setzen hält fest, wann das geschah, und dieser Eintrag überlebt einen späteren Wechsel auf closed: Dass jemandem geantwortet wurde, wird nicht dadurch ungeschehen, dass der Vorgang abgelegt wird.
Pfadparameter
| Name | Typ | Beschreibung |
|---|---|---|
inquiry_iderforderlich | string | Anfragekennung. Beispiel: inq_db6f3d5316884c649ea1848c278bbf44 |
Felder im Rumpf
| Name | Typ | Beschreibung |
|---|---|---|
statuserforderlich | string | Der Zustand, in den sie versetzt wird. new | read | replied | closed | spam Beispiel: new |
Rumpf der Anfrage
{ "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" }