---
title: "Validate Invitation"
method: POST
path: "/api/access-invitations/validate"
tags: ["access-invitations"]
---

# Validate Invitation

`POST /api/access-invitations/validate`

## Request

- Base URL: `https://app.thinqos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.thinqos.com/api/access-invitations/validate`
- Auth: none declared

Return the invitation state; when valid, its masked recipient and trial offer.

## Request body

- InvitationBody
  - `invitation` string, required

## Response `200`

Successful Response

- InvitationValidationResponse
  - `status` 'valid' | 'expired' | 'unavailable', required
  - `masked_email` string, nullable
  - `email` string, nullable
  - `name` string, nullable
  - `trial_offer` TrialOffer: What a new account starts with, read from ``platform_trial_config`` (TOS-7368).
    - `amount_usd` number, required
    - `duration_days` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/thinqos/apis/thinqos-api.md) · [All operations](https://skmtc.dev/thinqos/apis/thinqos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thinqos/apis/thinqos-api/revisions/5387b4ded614?raw)