Skip to content
Kwickblocks Developers

Get opening hours

GET
/public/v1/opening-hours
curl --request GET \
  --url https://example.kwickbooking.com/public/v1/opening-hours \
  --header 'Authorization: Bearer <token>'

Returns the venue’s weekly opening hours with any date-range changes, and its special one-off dates, as the venue published them in its knowledge base. The summary says whether the venue is open today and lists special dates in the next 30 days.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
venueId
string format: uuid

Responses

Section titled “Responses”

200

Section titled “200”

OK

Media typeapplication/json

GET /public/v1/opening-hours: regular and special hours from the knowledge base.

object
venueId
required
string format: uuid
source
required
string
regular
required
special
required
One of:
null
summary
required
string
Example
{
  "venueId": "01920000-0000-7000-8000-000000000001",
  "source": "knowledge-base",
  "regular": {
    "defaultSchedule": {
      "times": [
        {
          "day": "Friday",
          "openTime": "17:00",
          "closeTime": "02:00",
          "isClosed": false
        }
      ]
    },
    "overrides": []
  },
  "special": {
    "items": [
      {
        "name": "Christmas Eve",
        "validFrom": "2026-12-24",
        "validThrough": "2026-12-24",
        "opens": "17:00",
        "closes": "23:00"
      }
    ]
  },
  "summary": "Soho: open today, Fri 17/10, 17:00–02:00"
}

400

Section titled “400”

Venue required (https://developers.kwickblocks.ai/problems/venue-required)

Media typeapplication/problem+json

RFC 9457 problem details. type is a URI with a page describing the problem.

object
type
required
string format: uri
title
required
string
status
required
integer format: int32
detail
required

Safe to read to a guest.

string
instance
string
traceId
string
code

A machine-readable code on the widget’s routes.

string
Examples
Examplevenue-required

Venue required

{
  "type": "https://developers.kwickblocks.ai/problems/venue-required",
  "title": "Venue required",
  "status": 400,
  "detail": "Please say which venue this is for."
}

401

Section titled “401”

Invalid or missing integration key (https://developers.kwickblocks.ai/problems/invalid-key)

Media typeapplication/problem+json

RFC 9457 problem details. type is a URI with a page describing the problem.

object
type
required
string format: uri
title
required
string
status
required
integer format: int32
detail
required

Safe to read to a guest.

string
instance
string
traceId
string
code

A machine-readable code on the widget’s routes.

string
Examples
Exampleinvalid-key

Invalid or missing integration key

{
  "type": "https://developers.kwickblocks.ai/problems/invalid-key",
  "title": "Invalid or missing integration key",
  "status": 401,
  "detail": "This integration key isn't valid. Ask the venue's admin for a new one."
}

403

Section titled “403”

Capability not granted (https://developers.kwickblocks.ai/problems/capability-missing)

Media typeapplication/problem+json

RFC 9457 problem details. type is a URI with a page describing the problem.

object
type
required
string format: uri
title
required
string
status
required
integer format: int32
detail
required

Safe to read to a guest.

string
instance
string
traceId
string
code

A machine-readable code on the widget’s routes.

string
Examples
Examplecapability-missing

Capability not granted

{
  "type": "https://developers.kwickblocks.ai/problems/capability-missing",
  "title": "Capability not granted",
  "status": 403,
  "detail": "This integration key isn't allowed to do that. Ask the venue's admin to add the capability."
}

404

Section titled “404”

Venue not found (https://developers.kwickblocks.ai/problems/venue-not-found); Not published (https://developers.kwickblocks.ai/problems/knowledge-not-found)

Media typeapplication/problem+json

RFC 9457 problem details. type is a URI with a page describing the problem.

object
type
required
string format: uri
title
required
string
status
required
integer format: int32
detail
required

Safe to read to a guest.

string
instance
string
traceId
string
code

A machine-readable code on the widget’s routes.

string
Examples

Venue not found

{
  "type": "https://developers.kwickblocks.ai/problems/venue-not-found",
  "title": "Venue not found",
  "status": 404,
  "detail": "I couldn't find that venue."
}

429

Section titled “429”

Too many requests (https://developers.kwickblocks.ai/problems/rate-limited)

Media typeapplication/problem+json

RFC 9457 problem details. type is a URI with a page describing the problem.

object
type
required
string format: uri
title
required
string
status
required
integer format: int32
detail
required

Safe to read to a guest.

string
instance
string
traceId
string
code

A machine-readable code on the widget’s routes.

string
Examples
Examplerate-limited

Too many requests

{
  "type": "https://developers.kwickblocks.ai/problems/rate-limited",
  "title": "Too many requests",
  "status": 429,
  "detail": "There have been too many requests. Please try again in a minute."
}

503

Section titled “503”

Temporarily unavailable (https://developers.kwickblocks.ai/problems/service-unavailable)

Media typeapplication/problem+json

RFC 9457 problem details. type is a URI with a page describing the problem.

object
type
required
string format: uri
title
required
string
status
required
integer format: int32
detail
required

Safe to read to a guest.

string
instance
string
traceId
string
code

A machine-readable code on the widget’s routes.

string
Examples
Exampleservice-unavailable

Temporarily unavailable

{
  "type": "https://developers.kwickblocks.ai/problems/service-unavailable",
  "title": "Temporarily unavailable",
  "status": 503,
  "detail": "That information isn't available right now. Please try again shortly."
}