Ontwikkelaars

De publieke API van Stayo

De publieke REST API van Stayo laat u eigen integraties, apps en rapportages bouwen op boekingen, gasten, kamers en tarieven. Authenticatie met API-sleutel.

Base URLhttps://api.stayo.se/public/v1/

Wat kunt u bouwen?

Eigen integraties

Verbind Stayo met uw bestaande systemen — CRM, marketing automation, ERP of eigen tools.

Eigen apps

Bouw eigen interfaces voor receptie, schoonmaak of management bovenop dezelfde data die Stayo gebruikt.

Rapportages & BI

Haal boekingen, bezetting en omzet op in Power BI, Looker Studio, Excel of uw eigen datawarehouse.

Automatisering

Start workflows in Make, Zapier of n8n bij nieuwe boekingen, aankomsten of betalingen.

Authenticatie

Alle aanroepen worden geauthenticeerd met een API-sleutel die u aanmaakt onder Instellingen → Ontwikkelaars in Stayo. Stuur de sleutel mee als Bearer-token in de Authorization-header.

• Aparte sleutels voor test en productie (sk_test_… / sk_live_…).
• De sleutel wordt slechts één keer getoond — bewaar hem veilig.
• Altijd verzonden via HTTPS. Nooit in clientcode of in de URL.
• Kan op elk moment worden vernieuwd of ingetrokken.

curl https://api.stayo.se/public/v1/bookings \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxx" \
  -H "Accept: application/json"

Endpoints (selectie)

REST API met JSON. De volledige OpenAPI-specificatie wordt verstrekt aan actieve integrators.

Methode	Pad	Beschrijving
GET	/bookings	Boekingen ophalen met filters op datum, status en kanaal.
POST	/bookings	Een nieuwe boeking aanmaken.
GET	/bookings/{id}	Een boeking ophalen.
PATCH	/bookings/{id}	Status, datums of gastgegevens bijwerken.
GET	/guests	Gasten zoeken en ophalen.
GET	/rooms	Kamers, kamertypes en beschikbaarheid ophalen.
GET	/rates	Tarieven en prijsregels ophalen.
GET	/invoices	Facturen en bonnen ophalen.
POST	/webhooks	Webhooks registreren voor realtime events.

Voorbeeldantwoord

{
  "data": [
    {
      "id": "bk_01HXYZ...",
      "status": "confirmed",
      "channel": "booking.com",
      "arrival": "2026-08-12",
      "departure": "2026-08-15",
      "guest": { "name": "Anna Andersson", "email": "anna@example.com" },
      "room": { "id": "rm_12", "type": "Dubbelrum" },
      "total": { "amount": 4200, "currency": "SEK" }
    }
  ],
  "meta": { "page": 1, "per_page": 50, "total": 128 }
}

Rate limits

Standaard 60 aanroepen per minuut per API-sleutel. De actuele status staat in de response-headers X-RateLimit-Remaining en X-RateLimit-Reset. Meer nodig? Neem contact met ons op.

Versiebeheer

De versie staat in de URL (/public/v1/). Niet-brekende wijzigingen kunnen binnen dezelfde versie worden toegevoegd. Brekende wijzigingen komen alleen in nieuwe versies met minimaal 6 maanden overlap.

Webhooks

Abonneer u op events zoals booking.created, booking.updated en payment.succeeded. Alle webhooks zijn ondertekend met HMAC-SHA256.

Aan de slag met de API

De API is beschikbaar voor Stayo-klanten vanaf het Growth-pakket. Neem contact op en wij activeren de toegang, sturen de OpenAPI-specificatie en helpen u op weg.

Neem contact op hej@stayo.se