---
title: "Retrieve a list of meetings"
method: GET
path: "/v1/meetings"
tags: ["Meetings"]
---

# Retrieve a list of meetings

`GET /v1/meetings`

## Query parameters

- `from` string, date-time, required
- `to` string, date-time
- `pageNumber` number
- `pageSize` number
- `salesforceAccountId` string
- `salesforceOpportunityId` string
- `attendeeEmailAddresses` string[]
- `sourceTypes` string
- `includeDownloadUrl` boolean

## Response `200`

A list of meetings.

- object
  - `meetings` Meeting[], required
    - `id` string
    - `title` string
    - `startTime` string, date-time
    - `endTime` string, date-time
    - `host` object
      - `email` string
      - `name` string
    - `attendees` Attendee[]
      - `id` string
      - `name` string, required
      - `email` string, email, required
      - `isInternal` boolean, required
      - `salesforceCaseId` string
      - `salesforceLeadId` string
    - `transcript` object
      - `entries` TranscriptEntry[]
        - `speaker` object
          - `name` string, required
          - `attendeeId` string
        - `timestamp` string
        - `timestampSeconds` number
        - `text` string, required
    - `salesforceAccountId` string
    - `salesforceLeadId` string
    - `salesforceOpportunityId` string
    - `downloadUrl` string, uri — Pre-signed URL to download the meeting recording. Valid for 2 hours from the time of the API request. Only present when includeDownloadUrl=true and the meeting has a recording available.
    - `downloadUrlExpiresAt` string, date-time — Expiration time of the download URL in ISO 8601 format (UTC). Only present when includeDownloadUrl=true and downloadUrl is generated.
  - `pageCount` number — Total number of pages available for the current query.

---

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