---
title: "Get invitation of investor"
method: GET
path: "/v0/investors/{investorId}/invitations/{id}"
tags: ["Users"]
---

# Get invitation of investor

`GET /v0/investors/{investorId}/invitations/{id}`

## Request

- Base URL: `https://distributor-api.spiko.io`
- URL: `https://distributor-api.spiko.io/v0/investors/{investorId}/invitations/{id}`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/spiko/apis/spiko-distributor-api/docs/v0/investors/:investorId/invitations/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

**Retrieve a user invitation by its ID.**

- Returns the invitation with its current status (`pending` or `accepted`).
- Useful for looking up an invitation when receiving an `investor-invitation.accepted` webhook.

## Path parameters

- `investorId` string, uuid, required: a Universally Unique Identifier
- `id` string, uuid, required: a Universally Unique Identifier

## Response `200`

Success

- union
  - object
    - `id` string, uuid, required: a Universally Unique Identifier
    - `investorId` string, uuid, required: a Universally Unique Identifier
    - `email` string, required
    - `firstName` string, required: a valid name, of max size 255, non empty, without number, some special characters are forbidden
    - `lastName` string, required: a valid name, of max size 255, non empty, without number, some special characters are forbidden
    - `role` 'admin' | 'coordinator' | 'manager' | 'viewer' | 'legal-representative', required
    - `createdAt` string, required: A valid date within the range 2020-2100
    - `status` 'pending', required
  - object
    - `id` string, uuid, required: a Universally Unique Identifier
    - `investorId` string, uuid, required: a Universally Unique Identifier
    - `email` string, required
    - `firstName` string, required: a valid name, of max size 255, non empty, without number, some special characters are forbidden
    - `lastName` string, required: a valid name, of max size 255, non empty, without number, some special characters are forbidden
    - `role` 'admin' | 'coordinator' | 'manager' | 'viewer' | 'legal-representative', required
    - `createdAt` string, required: A valid date within the range 2020-2100
    - `status` 'accepted', required
    - `acceptedAt` string, required: A valid date within the range 2020-2100
    - `userId` string, uuid, required: a Universally Unique Identifier

## Other responses

- `400`: The request did not match the expected schema
- `401`: Authentication failed. Two bodies are possible: the schema below when the API rejects the credentials, and `{ "error": { "code", "status", "request", "message" } }` when the API gateway rejects them first. Only the former carries a `_tag`.
- `403`: Forbidden
- `404`: NotFound
- `503`: The investor is undergoing a scheduled upgrade, access is temporarily paused to ensure data safety.

---

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