> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meetjamie.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Meetings

> Retrieve a paginated list of meetings

Returns a paginated list of meetings, ordered by start time (newest first).

<Tabs>
  <Tab title="Workspace key">
    ```
    GET /v1/workspace/meetings.list
    ```

    Returns all meetings across the workspace.

    ### Parameters

    | Parameter   | Type   | Default | Description                                                         |
    | ----------- | ------ | ------- | ------------------------------------------------------------------- |
    | `limit`     | number | `50`    | Number of meetings to return (max `100`)                            |
    | `cursor`    | string | —       | Pagination cursor from a previous response                          |
    | `startDate` | string | —       | ISO 8601 date. Only return meetings starting on or after this date  |
    | `endDate`   | string | —       | ISO 8601 date. Only return meetings starting on or before this date |
    | `userEmail` | string | —       | Filter by a specific user's email                                   |

    ### Example Request

    ```bash theme={null}
    curl -H "x-api-key: jk_your_workspace_key" \
      'https://beta-api.meetjamie.ai/v1/workspace/meetings.list?input={"json":{"limit":10,"startDate":"2024-11-01T00:00:00Z"}}'
    ```

    **Filter by user:**

    ```bash theme={null}
    curl -H "x-api-key: jk_your_workspace_key" \
      'https://beta-api.meetjamie.ai/v1/workspace/meetings.list?input={"json":{"limit":5,"userEmail":"sarah@example.com"}}'
    ```
  </Tab>

  <Tab title="Personal key">
    ```
    GET /v1/me/meetings.list
    ```

    Returns your own meetings plus meetings shared with you (directly or via shared tags).

    ### Parameters

    | Parameter   | Type   | Default | Description                                                         |
    | ----------- | ------ | ------- | ------------------------------------------------------------------- |
    | `limit`     | number | `50`    | Number of meetings to return (max `100`)                            |
    | `cursor`    | string | —       | Pagination cursor from a previous response                          |
    | `startDate` | string | —       | ISO 8601 date. Only return meetings starting on or after this date  |
    | `endDate`   | string | —       | ISO 8601 date. Only return meetings starting on or before this date |
    | `tag`       | string | —       | Filter by tag name                                                  |

    ### Example Request

    ```bash theme={null}
    curl -H "x-api-key: jk_your_personal_key" \
      'https://beta-api.meetjamie.ai/v1/me/meetings.list?input={"json":{"limit":10,"startDate":"2024-11-01T00:00:00Z"}}'
    ```

    **Filter by tag:**

    ```bash theme={null}
    curl -H "x-api-key: jk_your_personal_key" \
      'https://beta-api.meetjamie.ai/v1/me/meetings.list?input={"json":{"limit":5,"tag":"Product"}}'
    ```
  </Tab>
</Tabs>

## Example Response

```json theme={null}
{
  "result": {
    "data": {
      "json": {
        "meetings": [
          {
            "id": "7893456789012345678",
            "title": "Q4 Planning Meeting",
            "generatedTitle": "Q4 Product Roadmap Review",
            "startTime": "2024-11-27T14:00:00.000Z",
            "endTime": "2024-11-27T15:00:00.000Z",
            "calendarEventId": "calendar-event-123",
            "userId": "user-456"
          }
        ],
        "nextCursor": "2024-11-20T10:00:00.000Z::7893456789012345677"
      }
    }
  }
}
```

## Response Fields

| Field                        | Type           | Description                                            |
| ---------------------------- | -------------- | ------------------------------------------------------ |
| `meetings`                   | array          | List of meeting objects                                |
| `meetings[].id`              | string         | Unique meeting ID                                      |
| `meetings[].title`           | string         | Meeting title                                          |
| `meetings[].generatedTitle`  | string \| null | AI-generated title                                     |
| `meetings[].startTime`       | string         | ISO 8601 start time                                    |
| `meetings[].endTime`         | string \| null | ISO 8601 end time                                      |
| `meetings[].calendarEventId` | string \| null | Linked calendar event ID                               |
| `meetings[].userId`          | string         | ID of the user who recorded the meeting                |
| `nextCursor`                 | string \| null | Cursor for the next page, or `null` if no more results |