---
title: "List meetings"
method: GET
path: "/v1/meetings"
tags: ["Meetings"]
---

# List meetings

`GET /v1/meetings`

List all meetings. Optionally filter by book_id to scope to a specific book.

## Query parameters

- `page` integer
- `per_page` integer
- `book_id` string
- `starts_after` string, date-time
- `starts_before` string, date-time
- `q` string
- `attendee` string
- `user_id` string

## Response `200`

successful

- object
  - `data` object[], required
    - `id` string, required
    - `title` string, required
    - `start_time` string, date-time, nullable
    - `end_time` string, date-time, nullable
    - `duration_seconds` integer
    - `meeting_link` string, nullable
    - `meeting_source` 'instant' | 'calendar_event' | 'imported' | 'logged', nullable
    - `meeting_type` string
    - `book_id` string, required
    - `households` object[], required
      - `id` string
      - `name` string
    - `users` object[]
      - `id` string
      - `email` string
      - `first_name` string, nullable
      - `last_name` string, nullable
    - `has_transcript` boolean, required
    - `has_recordings` boolean, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `pagination` object, required
    - `current_page` integer
    - `total_pages` integer
    - `total_count` integer
    - `per_page` integer

## Other responses

- `400` — bad request - invalid JSON
- `401` — unauthorized - missing or invalid token
- `403` — forbidden

---

[API](https://skmtc.net/slant/apis/slant-public-api-v1.md) · [All operations](https://skmtc.net/slant/apis/slant-public-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/slant/slant-public-api-v1/revisions/b56e0d137554/schema)