---
title: "Get a list of owned meetings"
method: GET
path: "/v2/meetings"
tags: ["Meetings"]
---

# Get a list of owned meetings

`GET /v2/meetings`

## Request

- Base URL: `https://app.meet.ps/api`
- URL: `https://app.meet.ps/api/v2/meetings`
- Auth: HTTP bearer

Lists data on meetings owned by the user.

## Response `200`

- object
  - `result` MeetingSQL[]
    - `id` integer: Internal meeting ID.
    - `parentId` integer: ID of the first meeting from the series this item could belong to.
    - `aliases` string[]: A list of meeting aliases that can be used as a substitute for meeting ID for participant-facing URLs (e.g. an attendee link). Normally only one is available, and that alias carries over with meeting restarts so that attendees don't need get a new link.
    - `name` string: Canonical / default meeting string ID to be used in URLs, including API calls.
    - `altName` string: Alternative, internal ID-like name for a meeting. Optional and non-unique.
    - `suffix` string: Legacy meeting name suffix for archived meetings. Normally empty. Suffixed meetings use the name and suffix concatenated with underscore as canonical string ID.
    - `caption` string: Human readable, friendly name as provided by the owner.
    - `modifiedAt` integer: Last modification timestamp, in ms.
    - `createdAt` integer: Item creation timestamp, in ms.
    - `startedAt` integer: Timestamp for the lifecycle transition of the meeting from being created to being published, in ms.
    - `closedAt` integer: Timestamp for the last unpublishing event of a meeting, in ms.
    - `archivedAt` integer: Timestamp for the restart procedure which occurred for the meeting. Archived meetings cannot be re-published.
    - `scStartedAt` integer: Timestamp for when the meeting is expected to take place according to the owner's schedule.
    - `scEndedAt` integer: Timestamp for when the meeting is expected to conclude.
    - `scStartedTime` boolean: Whether the scheduled start timestamp provides for an actual time (hours & minutes) and not only date.
    - `scEndedTime` boolean: Whether the scheduled end timestamp provides for an actual end time and not just date.
    - `timezone` string: Meeting timezone, defaults to the the customer's current timezone if missing.
    - `ownerId` integer: Meeting owner's internal ID in the system.
    - `role` string: Denotes the role of the querying user in a given meeting. Shows for meetings the querying user does not own.
    - `roles` object[]: List of roles granted to others for a given meeting. Shows for meetings owned by the querying user.
      - `userId` integer: Internal ID of the user who's been granted a role in the meeting.
      - `role` string: Role granted in a meeting.
    - `participants` integer: Total number of unique attendee sessions that interacted with the meeting.

## Other responses

- `401`: Access token is missing or invalid

---

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