Skip to content
Kwickblocks Developers

List event dates

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

Lists every published date of the venue’s events with seats left. ListUpcomingEvents returns them grouped by event for a date range.

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
Array<object>

Public event-instance summary (a dated occurrence with tier availability).

object
eventInstanceId
required
string format: uuid
eventId
required
string format: uuid
startAt
required
string format: date-time
remainingSeats
required
integer format: int32
Example
[
  {
    "eventInstanceId": "01920000-0000-7000-8000-000000000005",
    "eventId": "01920000-0000-7000-8000-000000000004",
    "startAt": "2026-10-23T19:00:00+00:00",
    "remainingSeats": 18
  }
]

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)

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-not-found

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."
}