---
title: "List venue spaces"
method: GET
path: "/venues/{venueId}/spaces"
tags: ["Venues"]
---

# List venue spaces

`GET /venues/{venueId}/spaces`

## Request

- Base URL: `https://joinways.app/api/v1`
- URL: `https://joinways.app/api/v1/venues/{venueId}/spaces`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://joinways.app/oauth/authorize`, token URL `https://joinways.app/api/oauth/token`, scopes: `mcp.read`)

Spaces (rooms) of the venue, by display_order then name, with their read-only features. An unknown venue returns an empty list. **Role permission:** none (any member).

## Response `200`

Spaces.

- object
  - `spaces` object[], required
    - `id` string, uuid
    - `name` string
    - `type` string, nullable
    - `capacity` integer, nullable
    - `surface` integer, nullable: Square metres.
    - `description` string, nullable
    - `color` string, nullable
    - `display_order` integer: Order in lists (then by name).
    - `layout_capacities` object: Seats per layout; `capacity` stays the headline figure. Keys: theatre, classroom, banquet, cabaret, cocktail, u_shape, boardroom.
    - `combined_space_ids` string[]: This space is the combination of these spaces of the same venue (movable walls). Booking it takes them; booking one of them conflicts with it. Empty for a plain space.
    - `setup_minutes` integer: Set-up time before each use, counted as occupied in conflicts.
    - `teardown_minutes` integer: Tear-down time after each use, counted as occupied in conflicts.
    - `rental_fee` number, nullable: Hire fee excl. tax, venue currency (quote reference).
    - `min_spend` number, nullable: Minimum spend excl. tax when the space is booked.
    - `address` string, nullable

## Other responses

- `401`: Missing, invalid, expired or revoked bearer token (`unauthorized`).
- `429`: Too many requests (`rate_limited`). `details.reason`: `per-ip`, `per-account-minute`, `per-account-day`, or `email_rate_limited` (email budget). Always carries `Retry-After`: wait that many seconds.

---

[API](https://skmtc.dev/joinways/apis/joinways-public-api.md) · [All operations](https://skmtc.dev/joinways/apis/joinways-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/joinways/apis/joinways-public-api/revisions/39e84309953e?raw)