---
title: "Get a team invitation"
method: GET
path: "/v1/team-invitations/{invitationId}"
tags: ["Teams"]
---

# Get a team invitation

`GET /v1/team-invitations/{invitationId}`

## Request

- Base URL: `https://api.spacefast.com`
- URL: `https://api.spacefast.com/v1/team-invitations/{invitationId}`
- Auth: HTTP bearer

Returns the inviting team's name, the masked invitee address, and whether the invitation can still be accepted.

## Path parameters

- `invitationId` string, required: The invitation id (the token from the invite link).

## Response `200`

Response for status 200

- object
  - `$schema` string, uri: Canonical JSON Schema URL for this response body. The server also sends it in the `Link: rel="describedby"` response header.
  - `data` object, required
    - `id` string, required: Invitation id.
    - `teamName` string, required: Inviting team's display name.
    - `email` string, required: The invited address, masked (`ja****@example.com`); never the full address.
    - `status` 'pending' | 'accepted' | 'rejected' | 'canceled' | 'expired', required: Current state of the invitation. Only `pending` can be accepted.
    - `expiresAt` string, required: Instant when the invitation expires.
    - `requiresTwoFactor` boolean, required: Whether the team requires two-factor authentication. Accepting needs an account with two-factor on.

## Other responses

- `default`: Problem details (RFC 9457). Any 4xx/5xx response is one `application/problem+json` document.

---

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