---
title: "List invitations for an organization"
method: GET
path: "/organizations/{organizationID}/invitations"
tags: ["Organizations"]
---

# List invitations for an organization

`GET /organizations/{organizationID}/invitations`

Retrieve all invitations for an organization with optional filtering by status, email, and name.

## Query parameters

- `status` 'pending' | 'expired'
- `email` string
- `first_name` string
- `last_name` string
- `search` string
- `first` integer
- `max` integer

## Response `200`

List of invitations retrieved successfully

- object
  - `invitations` OrganizationInvitation[], required
    - `id` string, required — Unique identifier for the invitation
    - `organization_id` string, required
    - `email` string, email, required — Email address of the invited user
    - `first_name` string, nullable — First name of the invited user
    - `last_name` string, nullable — Last name of the invited user
    - `created_at` string, date-time, required — Timestamp when the invitation was created
    - `expires_at` string, date-time, required — Timestamp when the invitation expires
    - `status` 'pending' | 'expired', required — Current status of the invitation

## Other responses

- `400` — Error returned when the request is malformed or contains invalid parameters
- `401` — Error returned when authentication or authorization fails
- `403` — Error returned when authentication or authorization fails
- `404` — Generic error response
- `5XX` — Unexpected Error

## Changes

- **2026-08-31** `16b3a31dfdf8` — 1 warning
  - removed the optional property `invitations/items/invite_link` from the response with the `200` status
- **2026-07-14** `fcbf82ebfc05` — 1 warning
  - deleted the `path` request parameter `organizationID`
- **2026-04-15** `a2cc5189d200` — 1 breaking
  - added the new path request parameter `organizationID`

[Change history](https://skmtc.dev/xataio/apis/xata-api/changes/organizations/:organizationID/invitations/get.md)

---

[API](https://skmtc.dev/xataio/apis/xata-api.md) · [All operations](https://skmtc.dev/xataio/apis/xata-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/xataio/xata-api/revisions/16b3a31dfdf8/schema)