---
title: "List meeting invites"
method: GET
path: "/v1/meetings/invites"
tags: ["Meetings"]
---

# List meeting invites

`GET /v1/meetings/invites`

List meeting invites for the authenticated organization, most recent
first. Filter by `status` to find invites in a particular lifecycle
state — for example `pending` invites that have not joined yet, or
`active` invites currently in a call.

## Query parameters

- `page` integer
- `perPage` integer
- `status` 'pending' | 'active' | 'cancelled' | 'ended' | 'failed'

## Response `200`

Successfully retrieved meeting invites

- object
  - `data` MeetingInvite[]
    - `id` string, uuid, required — Unique identifier for the meeting invite.
    - `provider` 'google_meet' | 'zoom' | 'microsoft_teams', required — Meeting provider inferred from the meeting URL.
    - `meetingUrl` string, uri, required — Normalized meeting URL.
    - `displayName` string, required — Display name used in the meeting.
    - `status` 'pending' | 'active' | 'cancelled' | 'ended' | 'failed', required — Current invite status.
    - `createdAt` string, date-time, required — Time the invite was created.
    - `joinAt` string, date-time, nullable, required — Scheduled time the persona joins the meeting, or null when the persona was asked to join immediately.
    - `groupCall` boolean, required — Whether group-call turn-taking is enabled for this invite (respond only when addressed by name; silent join).
    - `sessionId` string, nullable, required — Engine session ID once the meeting session has started, otherwise null.
    - `region` 'eu' | 'us-east' | 'us-west' | 'null', nullable, required — Region the persona joined the call from. May differ from the requested region when the invite was served by another region for availability. Additional region values may be introduced over time; treat unrecognized values as informational rather than an error.
    - `joinState` 'joining' | 'waiting_room' | 'in_call' | 'media_denied' | 'media_granted' | 'media_active' | 'left' | 'done' | 'error' | 'null', nullable, required — Latest observed call-participation detail for the persona, updated asynchronously as the persona connects, waits for admission, joins, and leaves. Null until the first update arrives. Values may be added over time; treat unrecognized values as informational.
    - `statusReason` string, nullable, required — Reason attached to a terminal participation state — for example `removed_by_host`, `meeting_ended`, `not_admitted`, `join_denied`, `meeting_link_invalid`, `meeting_not_started`, `idle_timeout`, `left_call`, or `provider_error`. Null while the invite is in progress. Values may be added over time; treat unrecognized values as informational.
  - `meta` Pagination — Pagination metadata returned alongside the `data` array of every list endpoint.
    - `total` integer — Total number of items across all pages.
    - `lastPage` integer — Number of the last page.
    - `currentPage` integer — Number of the current page.
    - `perPage` integer — Number of items per page.
    - `prev` integer, nullable — Number of the previous page, or null if on the first page.
    - `next` integer, nullable — Number of the next page, or null if on the last page.

## Other responses

- `400` — Bad request - invalid query parameters.
- `401` — Unauthorized - missing or invalid API key.
- `403` — Forbidden - API key lacks the required permission.
- `500` — Server error.

---

[API](https://skmtc.net/anam/apis/anam-ai-api.md) · [All operations](https://skmtc.net/anam/apis/anam-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/anam/anam-ai-api/versions/67afd1c5db59/schema)