Skip to main content
GET
/
v1
/
venues
/
{venue_id}
curl https://api.saoma.io/v1/venues/8f1a9c3b-8d4e-4f21-a1b2-c3d4e5f60718 \
  -H "Authorization: Bearer $SAOMA_API_KEY"

{
  "data": {
    "id": "8f1a9c3b-8d4e-4f21-a1b2-c3d4e5f60718",
    "slug": "akasha-lutetia",
    "name": "Spa Akasha — Hôtel Lutetia",
    "image": "https://xfkujlgettlxdgrnqluw.supabase.co/storage/v1/object/public/venues/akasha.jpg",
    "cover_image": "https://xfkujlgettlxdgrnqluw.supabase.co/storage/v1/object/public/venues/akasha-cover.jpg",
    "city": "Paris",
    "country": "FR",
    "currency": "EUR",
    "status": "active",
    "vat": 20,
    "opening_time": "09:00:00",
    "closing_time": "21:00:00",
    "schedule_type": "recurring",
    "days_of_week": [1, 2, 3, 4, 5, 6],
    "recurrence_interval": 1,
    "recurring_start_date": "2026-01-01",
    "recurring_end_date": null,
    "venue_type": "hotel",
    "description": "Un sanctuaire de bien-être au cœur du 6ᵉ arrondissement.",
    "landing_subtitle": "Massages & soins du visage",
    "offert": false,
    "slot_interval": 30,
    "booking_hold_enabled": true,
    "booking_hold_duration_minutes": 10,
    "allow_out_of_hours_booking": false,
    "out_of_hours_surcharge_percent": 0
  }
}
Returns the public profile of one venue. Requires the venues:read scope.
This endpoint returns venue metadata only — it does not embed the treatment catalogue. To get the venue’s treatments, call GET /v1/venues/{venue_id}/treatments.

​
Path parameters

​
venue_id
string
required
The venue identifier — either the UUID id or the human-readable slug returned by GET /v1/venues.

​
Response

​
data
Venue
A Venue object (detail shape). The detail shape exposes scheduling fields (opening_time, closing_time, slot_interval, recurrence, booking-hold and out-of-hours settings) that the list shape omits.

​
Errors

HTTPBodyMeaning
403{ "error": "Forbidden" }Your key is scoped to another venue
404{ "error": "Venue not found" }Unknown id, or the venue is not public

​
Example

curl https://api.saoma.io/v1/venues/8f1a9c3b-8d4e-4f21-a1b2-c3d4e5f60718 \
  -H "Authorization: Bearer $SAOMA_API_KEY"

{
  "data": {
    "id": "8f1a9c3b-8d4e-4f21-a1b2-c3d4e5f60718",
    "slug": "akasha-lutetia",
    "name": "Spa Akasha — Hôtel Lutetia",
    "image": "https://xfkujlgettlxdgrnqluw.supabase.co/storage/v1/object/public/venues/akasha.jpg",
    "cover_image": "https://xfkujlgettlxdgrnqluw.supabase.co/storage/v1/object/public/venues/akasha-cover.jpg",
    "city": "Paris",
    "country": "FR",
    "currency": "EUR",
    "status": "active",
    "vat": 20,
    "opening_time": "09:00:00",
    "closing_time": "21:00:00",
    "schedule_type": "recurring",
    "days_of_week": [1, 2, 3, 4, 5, 6],
    "recurrence_interval": 1,
    "recurring_start_date": "2026-01-01",
    "recurring_end_date": null,
    "venue_type": "hotel",
    "description": "Un sanctuaire de bien-être au cœur du 6ᵉ arrondissement.",
    "landing_subtitle": "Massages & soins du visage",
    "offert": false,
    "slot_interval": 30,
    "booking_hold_enabled": true,
    "booking_hold_duration_minutes": 10,
    "allow_out_of_hours_booking": false,
    "out_of_hours_surcharge_percent": 0
  }
}