---
title: "Your meetings: group meetings you organize or are invited to + bookings you host or are assigned"
method: GET
path: "/api/me/meetings"
tags: ["Meetings"]
---

# Your meetings: group meetings you organize or are invited to + bookings you host or are assigned

`GET /api/me/meetings`

## Request

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

Group meetings match your sign-in email or a connected calendar address. Upcoming = not yet ended, sorted by start ascending; past sorted descending. A participant sees only the host in people (as on /m/<id>). Keyset pagination via nextCursor.

## Query parameters

- `scope` 'upcoming' | 'past'
- `kind` 'group' | 'booking'
- `limit` integer
- `cursor` string

## Response `200`

{ items, nextCursor }

- object
  - `items` object[]
    - `kind` 'group' | 'booking'
    - `id` string
    - `title` string
    - `start` string, date-time
    - `end` string, date-time
    - `status` 'confirmed' | 'cancelled' | 'pending'
    - `role` 'organizer' | 'participant' | 'host' | 'assignee'
    - `conference` object, nullable
      - `provider` 'google_meet' | 'teams' | 'null', nullable
      - `url` string, nullable
    - `people` object[]
      - `name` string, nullable
      - `email` string
    - `href` string: /m/<meetingId>, or /links for a booking without a meeting page.
  - `nextCursor` string, nullable

## Other responses

- `400`: invalid_scope | invalid_limit | invalid_cursor
- `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)