---
title: "List bookings"
method: GET
path: "/api/v1/bookings"
tags: ["account"]
---

# List bookings

`GET /api/v1/bookings`

## Request

- Base URL: `https://meettempi.com`
- URL: `https://meettempi.com/api/v1/bookings`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `tempi_session`

Lists bookings. Without `team`: the ones you host, in every team. With `team`: all of that team's bookings for admins, only yours for members. `when=upcoming` (default) lists soonest first and includes bookings awaiting payment. `past` lists newest first. `cancelled` lists cancellations. Or pass `from` and `to` (ISO, at most 62 days apart) for every active booking in that window, soonest first, such as a week view. `only=calendar_problems` keeps the bookings whose calendar event is missing, out of date or without its Meet or Teams link (see `calendarProblem`). Each booking has a `manageUrl` with the token that get_available_slots needs to reschedule it.

## Query parameters

- `when` 'upcoming' | 'past' | 'cancelled': upcoming (the default), past or cancelled
- `from` string, date-time: an ISO 8601 date and time with an offset, such as 2026-10-05T14:00:00Z
- `to` string, date-time: an ISO 8601 date and time with an offset, such as 2026-10-05T14:00:00Z
- `team` string: the id or slug of a team you belong to
- `only` 'calendar_problems': calendar_problems: only bookings with a `calendarProblem`
- `limit` union: how many bookings to return, 1 to 500 (default 50)
  - integer: an integer
  - string: a string to be decoded into a number

## Response `200`

Success

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/meettempi/apis/tempi-api.md) · [All operations](https://skmtc.dev/meettempi/apis/tempi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/meettempi/apis/tempi-api/revisions/36787210a2ce?raw)