---
title: "Dialpad Meeting -- List"
method: GET
path: "/api/v2/meetings"
tags: ["meetings"]
---

# Dialpad Meeting -- List

`GET /api/v2/meetings`

## Request

- Base URL: `https://dialpad.com`
- URL: `https://dialpad.com/api/v2/meetings`
- Auth: HTTP bearer

Lists all Dialpad meetings for a specified user.

Requires scope: ``conference:all``

Rate limit: 1200 per minute.

## Query parameters

- `cursor` string
- `user_id` integer, required
- `end_datetime` integer
- `start_datetime` integer, required

## Response `200`

A successful response

- ProtosUberconferenceMeetingMeetingsCollection
  - `cursor` string, nullable: A token used to return the next page of a previous request. Use the cursor provided in the previous response.
  - `data` ProtosUberconferenceMeetingMeetingsProto[], nullable: A list of meeting summaries.
    - `call_out` boolean, nullable: Whether or not the meeting should call the participants at the beginning of the conference.
    - `dial_in_number` string, nullable: The phone number to dial to join the conference.
    - `duration` integer, nullable: The duration of each meeting occurrence in seconds.
    - `end_datetime` string, date-time, nullable: The meeting's end time.
    - `id` string, nullable: The ID of the scheduled conference.
    - `instance_id` string, nullable: The ID of the scheduled conference instance.
    - `is_moderated` boolean, nullable: Whether or not the meeting is moderated.
    - `meeting_type` 'CUSTOM_UNIQUE_MEETING' | 'LARGE_MEETING' | 'PERSONAL' | 'UNIQUE_MEETING' | 'null', nullable: The meeting's type.
    - `meeting_url` string, nullable: The URL of the meeting.
    - `organizer_pin` string, nullable: The organizer's pin.
    - `participant_pin` string, nullable: The participant's pin.
    - `participants_info` ProtosUberconferenceMeetingMeetingParticipantProto[], nullable: The list of users that participate(d) in the meeting.
      - `call_in_method` string, nullable: The method this participant used to joined the meeting.
      - `contact_id` string, nullable: The participant's ID from the Dialpad Contacts API, when applicable.
      - `display_name` string, nullable: Name of the meeting participant.
      - `email` string, nullable: The email address of the participant. (if applicable)
      - `is_organizer` boolean, nullable: Whether or not the participant is the meeting's organizer.
      - `name` string, nullable: Name of the meeting participant.
      - `phone` string, nullable: The number that the participant dialed in from. (if applicable)
      - `phone_number` string, nullable: The number that the participant dialed in from. (if applicable)
      - `talk_time` integer, nullable: The amount of time this participant was speaking. (in milliseconds)
    - `recurrence` string, nullable: The number of times the meeting is repeated.
    - `recurrence_end_date` string, date-time, nullable: The recurrence series cutoff.
    - `start_datetime` string, date-time, nullable: The meeting's start time.
    - `timezone` string, nullable: Timezone using a tz database name.
    - `title` string, nullable: The meeting's title.

---

[API](https://skmtc.dev/dialpad/apis/dialpad-meetings.md) - [All operations](https://skmtc.dev/dialpad/apis/dialpad-meetings/llms.txt) - [OpenAPI document](https://skmtc.dev/dialpad/apis/dialpad-meetings/revisions/d586459d44b0?raw)