Venues

Get venue availability

Weekly opening hours, closures and enforcement mode of a venue (or of one of its spaces). A space inherits its venue's hours and closures unless it overrides them; the effective* fields are the resolved ones. effectiveEnforcementMode: block means events cannot be created or moved onto a closure or outside opening hours (the API answers 409 with details.reason: venue_unavailable). Pass space_ids to also get each space's own resolved availability in spaces. Role permission: none (any member).

get/venues/{venueId}/availability

Request

  • Base URL: https://joinways.app/api/v1
  • URL: https://joinways.app/api/v1/venues/{venueId}/availability
  • 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)

Query parameters

fromstring date

First day of the closures window (inclusive).

tostring date

Last day of the closures window (inclusive).

space_idsstring[]

Spaces of this venue (comma-separated or repeated, at most 50) whose resolved availability is added under spaces. An id that is not a space of the venue answers 404.

Response

Business hours, closures and resolved availability.

locationIdstring uuid
parentIdstring uuid nullable
autoImportHolidaysboolean
countrystring nullable
enforcementMode'warn' | 'block'
effectiveEnforcementMode'warn' | 'block'

Example response

{
  "ownBusinessHours": [
    {
      "openTime": "09:00",
      "closeTime": "23:00"
    }
  ],
  "effectiveBusinessHours": [
    {
      "openTime": "09:00",
      "closeTime": "23:00"
    }
  ],
  "spaces": [
    {
      "ownBusinessHours": [
        {
          "openTime": "09:00",
          "closeTime": "23:00"
        }
      ],
      "effectiveBusinessHours": [
        {
          "openTime": "09:00",
          "closeTime": "23:00"
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.