Skip to main content
Saoma is a SaaS platform for spa management — booking, scheduling, therapist coordination and billing. The Partner API lets external platforms (OTAs, hotel groups, wellness marketplaces) query real-time availability across every venue on Saoma and push bookings directly into our system.

​
What you can do with this API

List venues

Discover every active spa/hotel connected to Saoma, with their metadata and photos.

Retrieve a venue

Get a single venue’s public profile, including its opening hours and booking policy.

List treatments

Read a venue’s treatment catalogue, with prices, durations and variants.

Availability & bookings

Real-time availability and booking creation are coming soon — see the pages tagged Coming soon in the API Reference.

​
Environments

Credentials are provisioned by the Saoma team during onboarding. A dedicated sandbox environment is not yet available — contact us if you need isolated test data.
EnvironmentBase URL
Productionhttps://api.saoma.io/v1

​
Versioning

The current version is v1. The version is part of the URL (/v1/...). We commit to:
  • No breaking changes inside a major version.
  • Additive changes only (new optional fields, new endpoints) without notice.
  • Deprecations announced at least 6 months before removal, via email to the partner contact.

​
Conventions

  • Dates are ISO 8601 (YYYY-MM-DD); times such as opening_time are in the venue’s local timezone (exposed via the timezone field on the venue list shape).
  • Money amounts are decimal numbers in the venue’s currency (e.g. 120.00 for 120 €), alongside a currency code (ISO 4217). They are not integer cents.
  • All string IDs are opaque — do not parse or assume format stability.
  • Text fields are available in French and English. Fields suffixed _en contain the English translation; the primary field holds French.

​
Next steps

Authenticate

Get your API key and make your first call.

Quickstart

Build a full booking flow in 5 minutes.