---
title: "Get details of a specific invitation"
method: GET
path: "/organizations/{organizationID}/invitations/{invitationID}"
tags: ["Organizations"]
---

# Get details of a specific invitation

`GET /organizations/{organizationID}/invitations/{invitationID}`

## Request

- Base URL: `https://api.xata.tech`
- URL: `https://api.xata.tech/organizations/{organizationID}/invitations/{invitationID}`
- Auth: OAuth 2
  - Implicit: `https://auth.xata.io/realms/xata/protocol/openid-connect/auth`
  - Scopes: `invite:read`

Retrieve detailed information about a specific invitation by its ID.

## Response `200`

Invitation details retrieved successfully

- OrganizationInvitation
  - `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
  - `role` 'admin' | 'editor', required: The roles a member of an organization can hold

## 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-09-23** `6cb48fa2362d`: 1 info
  - removed the `viewer` enum value from the `role` response property for the response status `200`
- **2026-09-16** `8860b61b1842`: 1 info
  - added the required property `role` to the response with the `200` status
- **2026-08-31** `16b3a31dfdf8`: 1 warning
  - removed the optional property `invite_link` from the response with the `200` status
- **2026-07-14** `fcbf82ebfc05`: 2 warning
  - deleted the `path` request parameter `invitationID`
  - deleted the `path` request parameter `organizationID`
- **2026-04-15** `a2cc5189d200`: 2 breaking
  - added the new path request parameter `invitationID`
  - added the new path request parameter `organizationID`

[Operation history](https://skmtc.dev/xataio/apis/xata-api/changes/organizations/:organizationID/invitations/:invitationID/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.dev/xataio/apis/xata-api/revisions/4bc5ad58a6c6?raw)