---
title: "List the bookings a visitor sees"
method: GET
path: "/api/book/{token}/events"
tags: ["Public booking"]
---

# List the bookings a visitor sees

`GET /api/book/{token}/events`

## Request

- Base URL: `https://trmnl.com`
- URL: `https://trmnl.com/api/book/{token}/events`
- Auth: none declared

Public: no bearer token, so it is not an account operation and no agent tool offers it. The rolling week from start_at, as the public booking page shows it, with times in the room time zone. A collection token also takes resource_type and resource_id to pick one of its rooms.

## Query parameters

- `start_at` string, required
- `resource_type` string
- `resource_id` integer

## Response `200`

Success

- object
  - `events` PublicBookingEvent[]
    - `id` integer
    - `title` string
    - `startsAt` string
    - `endsAt` string
    - `actionLabel` string: Present when the visitor may cancel or end it
    - `actionMethod` 'delete' | 'patch'
    - `actionPath` string
    - `actionConfirm` string
  - `bookingLimit` integer: How many bookings may overlap; more than one for a desk pool
  - `fetched_at` string, date_time, nullable

## Other responses

- `400`: start_at is missing
- `410`: Unknown token, Booking with TRMNL off, or a room that cannot be booked: all look the same

---

[API](https://skmtc.dev/trmnl/apis/trmnl-api.md) · [All operations](https://skmtc.dev/trmnl/apis/trmnl-api/llms.txt) · [OpenAPI document](https://skmtc.dev/trmnl/apis/trmnl-api/revisions/66179e6d663b?raw)