Skip to main content
GET
/
v1
/
venues
/
{id}
Error
A valid request URL is required to generate request examples
{
  "name": "Downtown Event Center",
  "address": {},
  "label": "downtown-event-center",
  "type": "coworking",
  "spaces": [
    "<array>"
  ],
  "openingHours": [
    {
      "day": "monday",
      "open": "09:00",
      "close": "18:00"
    },
    {
      "day": "tuesday",
      "open": "09:00",
      "close": "18:00"
    }
  ],
  "metadata": {
    "import": "calendarId",
    "googleCalendarId": "primary"
  },
  "medias": [
    "<array>"
  ]
}

Authorizations

​
Authorization
string
header
required

OAuth2 authentication for Boseat API

Path Parameters

​
id
string
required

Unique identifier of the venue

Example:

"a3f1d7d0-ef1d-4b2e-aad2-123456789abc"

Response

Venue found and returned with complete details

​
name
string
required

Display name of the venue

Example:

"Downtown Event Center"

​
address
object
required

Physical address of the venue including street address, city, postal code, and country

​
label
string
required

URL-friendly slug used to identify the venue. Used in URLs and API calls.

Example:

"downtown-event-center"

​
type
enum<string>
required

Type of venue, which determines available features, space configurations, and booking rules

Available options:
coworking,
hotel,
event_space,
sports_facility,
podcast_studio,
meeting_center,
conference_center,
restaurant,
retail_space,
generic
Example:

"coworking"

​
spaces
array[]
required

List of spaces available within this venue. Each space can be booked independently and may have different capacities and features.

​
openingHours
object[]
required

Operating hours for the venue, defining when bookings are available. Each entry specifies a day of the week with opening and closing times.

Example:
[
  {
    "day": "monday",
    "open": "09:00",
    "close": "18:00"
  },
  {
    "day": "tuesday",
    "open": "09:00",
    "close": "18:00"
  }
]
​
metadata
object
required

Additional metadata for the venue. May include integration data, external system references, or custom configuration.

Example:
{
  "import": "calendarId",
  "googleCalendarId": "primary"
}
​
medias
array[]
required

Media files (images, videos) associated with the venue. Used for display in booking interfaces and marketing materials.