---
title: "Получить приглашения кабинета"
method: GET
path: "/api/v1/invitations"
tags: ["Invitations"]
---

# Получить приглашения кабинета

`GET /api/v1/invitations`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/invitations`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)

Все приглашения кабинета: ожидающие входа, принятые, отозванные и истёкшие. Просроченное ожидающее приглашение приходит со статусом expired. Ссылок и токенов в ответе нет.

## Headers

- `X-Tenant` string, required

## Response `200`

Приглашения кабинета

- InvitationPage
  - `count` integer, required
  - `results` Invitation[], required
    - `id` string, uuid, required
    - `tenant_id` string, uuid, required
    - `tenant_name` string
    - `email` string, required: Почта приглашения в нижнем регистре; принять можно только войдя с ней
    - `employee_id` string, uuid
    - `employee_name` string: ФИО карточки «Команды»
    - `first_name` string
    - `last_name` string
    - `middle_name` string
    - `role_id` string, uuid, required
    - `role_name` string
    - `company_scope` string, required: Всегда all — область задают бизнесы участника после принятия
    - `company_ids` UUID[], required
    - `invited_by` integer, required
    - `invited_by_name` string
    - `status` 'pending' | 'accepted' | 'revoked' | 'expired', required
    - `expires_at` string, date-time, required
    - `accepted_user_id` integer
    - `created_at` string, date-time, required
    - `accepted_at` string, date-time
    - `revoked_at` string, date-time
    - `invite_url` string: Одноразовая ссылка; только в ответе без письма и у выпуска ссылки
    - `access_until` string, date: Последний день доступа ГГГГ-ММ-ДД: после принятия становится датой закрытия доступа участника; нет поля — бессрочно
    - `link_id` string, uuid

## Other responses

- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/3c60ded179f2?raw)