---
title: "Get Invitation By Token"
method: GET
path: "/invitations/token/{token}"
tags: ["invitations"]
---

# Get Invitation By Token

`GET /invitations/token/{token}`

## Request

- Base URL: `https://platform.tracecat.com/api`
- URL: `https://platform.tracecat.com/api/invitations/token/{token}`
- Auth: API key in cookie `fastapiusersauth`

Get minimal invitation details by token (public endpoint for UI).

Returns organization name and inviter info for the acceptance page.
If user is authenticated, also returns whether their email matches the invitation.

## Path parameters

- `token` string, required

## Response `200`

Successful Response

- InvitationReadMinimal: Minimal public response for token-based lookup on the accept page. Excludes email, inviter ID, and timestamps to limit information disclosure.
  - `organization_id` string, uuid, required
  - `organization_name` string, required
  - `organization_slug` string, required
  - `inviter_name` string, nullable, required
  - `inviter_email` string, nullable, required
  - `grants` InvitationGrant[], required
    - `workspace_id` string, uuid, nullable
    - `role_id` string, uuid, required
  - `status` 'pending' | 'accepted' | 'revoked', required: Invitation lifecycle status.
  - `expires_at` string, date-time, required
  - `email_matches` boolean, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tracecat/apis/tracecat-api.md) - [All operations](https://skmtc.dev/tracecat/apis/tracecat-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tracecat/apis/tracecat-api/revisions/2efdda25045f?raw)