---
title: "List user meetings"
method: GET
path: "/v1/users/{user_id}/meetings"
tags: ["Meetings"]
---

# List user meetings

`GET /v1/users/{user_id}/meetings`

## Request

- Base URL: `http://0.0.0.0:3000`
- URL: `http://0.0.0.0:3000/v1/users/{user_id}/meetings`
- Auth: none declared

Returns meetings from the user's connected meeting integrations (Google Meet, Zoom, Teams).

**Filtering:**
- `start_date`: Meetings starting after this date (YYYY-MM-DD)
- `end_date`: Meetings starting before this date (YYYY-MM-DD)
- `has_summary`: Filter by summary presence (true/false)
- `provider`: Filter by provider (google_meet, zoom, teams, manual_meetings)

**Expand parameter**:
By default, `summary`, `short_summary`, `action_items`, `attendees`, and `meeting_link` are not included.
Use `expand=summary,short_summary,action_items,attendees,meeting_link` to include these fields.

**Pagination (cursor-only):**
- `limit`: Maximum number of meetings per page (default: 50, max: 100)
- `cursor`: Opaque token from `pagination.next_cursor` of a prior response. Pass it back unchanged to fetch the next page. Omit on the first page.

**Note:** Meetings are returned in reverse chronological order (most recent first).

## Path parameters

- `user_id` string, uuid, required

## Query parameters

- `start_date` string, date
- `end_date` string, date
- `has_summary` 'true' | 'false'
- `provider` 'google_meet' | 'zoom' | 'teams' | 'manual_meetings'
- `limit` string
- `cursor` string
- `expand` string

## Response `200`

Default Response

- object
  - `success` true, required
  - `data` object[], required
    - `id` string, required: Opaque meeting ID (mtg_xxx format)
    - `title` string, required: Meeting title
    - `meeting_code` string, nullable: Meeting code (e.g., Google Meet code)
    - `start_time` string, date-time, required: Meeting start time (ISO8601)
    - `end_time` string, date-time, required: Meeting end time (ISO8601)
    - `summary` string, nullable: AI-generated summary of the meeting
    - `short_summary` string, nullable: Brief one-line summary
    - `action_items` object[]: Extracted action items from the meeting
      - `description` string, required: Action item description
      - `assignee` string, nullable: Person assigned to the action
      - `due_date` string, nullable: Due date for the action (ISO8601)
      - `completed` boolean, nullable: Whether the action has been completed
    - `attendees` object[]: List of meeting attendees
      - `email` string, nullable: Attendee email address
      - `name` string, nullable: Attendee display name
      - `is_organizer` boolean, nullable: Whether this attendee is the organizer
      - `response_status` 'accepted' | 'declined' | 'tentative' | 'needsAction', nullable: Attendee's response to the meeting invitation
    - `meeting_link` string, nullable: Link to join or view the meeting
    - `has_transcript` boolean, required: Whether a transcript is available
    - `has_notes` boolean, required: Whether smart notes are available
    - `content_status` 'none' | 'notes_only' | 'transcript_only' | 'transcript_and_notes', required: Indicates which content types are available: transcript, smart notes, both, or none
    - `provider` 'google_meet' | 'zoom' | 'teams' | 'manual_meetings', required: Meeting provider
    - `event_id` string, nullable: Linked calendar event ID (evt_xxx format)
    - `created_at` string, date-time, required: When the meeting was created
    - `updated_at` string, date-time, nullable: When the meeting was last modified
  - `pagination` union, required
    - object
      - `limit` number, required
      - `has_more` true, required
      - `next_cursor` string, required
    - object
      - `limit` number, required
      - `has_more` false, required

## Other responses

- `400`: Default Response
- `401`: Default Response
- `500`: Default Response

---

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