---
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
    - `invite_link` string — URL link to accept 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

---

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