Docs

Overview

Last updated: 26 Oct 2026

The Storefront API is for external developers integrating SERVOS into customer-facing websites and applications.

Overview

The Storefront API is a JSON API for:

  • Browsing public catalog data (services, accommodations, events, passes).
  • Checking availability (service time slots, accommodation availability).
  • Building a cart and adding items (bookings, stays, tickets, passes) prior to checkout.

All Storefront endpoints are scoped to the organization that owns the API key — the organization is derived entirely from the key, never from the URL.

API surface area (what's supported)

The endpoints documented here are the entire supported public surface area of the Storefront API.

If you discover an endpoint under /store/v0/... that is not documented here, treat it as internal / not supported (it may be incomplete or subject to change without notice).

Quick start

  1. Get an API key from the SERVOS team (it determines your organization).
  2. Call the catalog endpoints (services / accommodations / events / passes).
  3. Call the availability endpoints to select a valid slot / date range.
  4. Create a cart and add items.

Base URL

The API is served from the dedicated api subdomain. All endpoints documented here are rooted at:

https://api.servos.dk/store/v0

Authentication

All requests must include a bearer token:

Authorization: Bearer YOUR_API_KEY

More details: see Authentication.

Guides

Authentication
Learn how to authenticate API requests with a bearer token.
Conventions
Request/response conventions, location scoping, and field naming.
Errors
How the API reports errors and how to handle them.
Types
Shared types and identifiers used across the API.
Services
Browse and fetch service catalog data for the organization.
Service availability
Check available time slots for services.
Accommodations
Browse accommodation catalog data for the organization.
Accommodation availability
Check availability for stays and date ranges.
Accommodation stay search
Prices, rooms left and free cancellation for one date range.
Accommodation availability dates
Per-day boolean availability for calendar views.
Events
Browse events and ticket types for the organization.
Packages
Browse packages and everything they contain.
Package search
Price a package for dates, guests and choices.
Passes
Browse prepaid passes and punch cards for the organization.
Carts
Create and manage carts before checkout.
Cart items
Add bookings, stays, and tickets to a cart.
Cart packages
Add a package to a cart and remove it.

Support

If anything is unclear or you need an endpoint that isn't documented here, contact the SERVOS team and include:

  • The request URL
  • A sanitized request payload (if applicable)
  • The response status + body
  • A correlation identifier (if you have one in your system logs)