---
title: "Get meetings"
method: GET
path: "/meetings"
---

# Get meetings

`GET /meetings`

Returns a list of meetings.

## Query parameters

- `cursor` string — The cursor for paginating through the results. To fetch the next page, set the `cursor` to the `cursor` returned by the previous request.
- `limit` integer — The limit for the pagination - the maximum number of results that will be returned within a single API response.
- `fields` string[] — Additional fields that should be populated. - `hostRoomUrl` - Include hostRoomUrl field in the meeting response. - `viewerRoomUrl` - Include viewerRoomUrl field in the meeting response.

## Response `200`

A JSON object with the page containing the array with the meetings results.

- object
  - `results` Meeting[], required
    - `meetingId` string, required — The ID of the meeting.
    - `roomName` string — The name of the room.
    - `roomUrl` string, uri, required — The URL to room where the meeting will be hosted.
    - `startDate` string, date-time — When the meeting starts. Always in UTC, regardless of the input timezone.
    - `endDate` string, date-time, required — When the meeting ends. Always in UTC, regardless of the input timezone.
    - `hostRoomUrl` string, uri — The URL to the room where the meeting will be hosted which will also make the user the host of the meeting. A host will get additional privileges like locking the room, and removing and muting participants, so you should be careful with whom you share this URL. The user will only become a host if the meeting is on-going (some additional slack is added to allow a host joining the meeting ahead of time or if the meeting goes over time). This field is optional and will only be returned if requested through the fields parameter.
    - `viewerRoomUrl` string, uri — The URL to the room where the meeting will be hosted which will make the user a viewer of the meeting. A viewer will not be able to turn on the camera or microphone, but will be able to join the meeting. This field is optional and will only be returned if requested through the fields parameter.
  - `cursor` string, required — The cursor for paginating through the results. To fetch the next page, set the `cursor` to the `cursor` returned by the previous request. If there are no more results, the value returned is `null`.

## Other responses

- `401` — Access token is missing or invalid
- `404` — The requested resource doesn't exist
- `429` — You are rate limited

---

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