Utvecklare

Stayos publika API

Stayos publika REST-API låter er bygga egna integrationer, appar och rapporter mot bokningar, gäster, rum och priser. Autentisering via API-nyckel.

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

Vad kan ni bygga?

Egna integrationer

Koppla Stayo mot era befintliga system — CRM, marketing automation, affärssystem eller egenutvecklade verktyg.

Skräddarsydda appar

Bygg egna gränssnitt för reception, städ eller ledning ovanpå samma data som Stayo använder.

Rapporter & BI

Hämta bokningar, beläggning och intäkter till Power BI, Looker Studio, Excel eller ert eget datalager.

Automation

Trigga arbetsflöden i Make, Zapier eller n8n baserat på nya bokningar, incheckningar eller betalningar.

Autentisering

Alla anrop autentiseras med en API-nyckel som ni skapar under Inställningar → Utvecklare i Stayo. Skicka nyckeln som Bearer-token i Authorization-headern.

• Separata nycklar för test och produktion (sk_test_… / sk_live_…).
• Nyckeln visas bara en gång — förvara den säkert.
• Skickas alltid över HTTPS. Aldrig i klientkod eller URL.
• Kan när som helst roteras eller återkallas.

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

Endpoints (urval)

REST-baserat API med JSON. Fullständig OpenAPI-specifikation lämnas till aktiva integratörer.

Metod	Path	Beskrivning
GET	/bookings	Lista bokningar med filter på datum, status och kanal.
POST	/bookings	Skapa en ny bokning.
GET	/bookings/{id}	Hämta en enskild bokning.
PATCH	/bookings/{id}	Uppdatera status, datum eller gästuppgifter.
GET	/guests	Sök och lista gäster.
GET	/rooms	Lista rum, rumstyper och tillgänglighet.
GET	/rates	Hämta priser och prisregler.
GET	/invoices	Lista fakturor och kvitton.
POST	/webhooks	Registrera webhooks för realtidshändelser.

Exempelrespons

{
  "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

60 anrop per minut per API-nyckel som standard. Aktuell status finns i svarsheadrarna X-RateLimit-Remaining och X-RateLimit-Reset. Behöver ni mer, hör av er.

Versionering

Versionen anges i URL:en (/public/v1/). Icke-brytande förändringar kan tillkomma inom samma version. Brytande förändringar sker enbart i nya versioner med minst 6 månaders överlapp.

Webhooks

Prenumerera på händelser som booking.created, booking.updated och payment.succeeded. Alla webhooks signeras med HMAC-SHA256.

Kom igång med API:et

API:et är tillgängligt för Stayo-kunder på Growth-plan och uppåt. Hör av er så aktiverar vi åtkomst, skickar OpenAPI-specifikationen och hjälper er igång.

Kontakta oss hej@stayo.se