---
title: "Bookings you own or attend as a team member (max 100)"
method: GET
path: "/api/bookings"
tags: ["Booking links"]
---

# Bookings you own or attend as a team member (max 100)

`GET /api/bookings`

## Request

- Base URL: `https://whenmeet.me`
- URL: `https://whenmeet.me/api/bookings`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `__Host-session`

## Query parameters

- `scope` 'upcoming' | 'past'

## Response `200`

{ bookings }

- object
  - `bookings` HostBooking[]
    - `id` string
    - `status` 'confirmed' | 'cancelled'
    - `startsAt` integer: unix ms
    - `endsAt` integer: unix ms
    - `eventTitle` string
    - `eventTypeId` string, nullable
    - `invitee` object
      - `name` string
      - `email` string
    - `guests` string[]
    - `answers` object[]
      - `id` string
      - `label` string
      - `answer` string
    - `notes` string, nullable
    - `assignedTo` object, nullable
      - `email` string
      - `name` string, nullable
    - `meetingId` string, nullable
    - `meetingUrl` string, nullable
    - `cancelReason` string, nullable
    - `cancelledBy` 'invitee' | 'host' | 'null', nullable
    - `createdAt` integer: unix ms
    - `isOwner` boolean
    - `canModify` boolean: Owner, organizer or the "any" assignee: may cancel / reschedule. An "all" teammate only sees it.

## Other responses

- `401`: unauthenticated (no session or token), or invalid_token (a Bearer token that is malformed, unknown or revoked — never a silent anonymous fallback).

---

[API](https://skmtc.dev/whenmeet/apis/whenmeet-me-api.md) · [All operations](https://skmtc.dev/whenmeet/apis/whenmeet-me-api/llms.txt) · [OpenAPI document](https://skmtc.dev/whenmeet/apis/whenmeet-me-api/revisions/202b80022215?raw)