---
title: "List Invitations"
method: GET
path: "/api/v1/auth-management/user-invitations"
tags: ["userManagement"]
---

# List Invitations

`GET /api/v1/auth-management/user-invitations`

List all pending user invitations.
This endpoint retrieves a list of all pending invitations in the organization.

## Query parameters

- `offset` integer
- `limit` integer

## Headers

- `Authorization` string, required

## Response `200`

A paginated list of pending user invitations

- UserInvitationListResponse — Response model for listing user invitations. This model contains a list of pending user invitations and metadata about the pagination of the results. Each invitation includes details about who sent it, who it was sent to, and the roles that will be assigned upon acceptance.
  - `user_invitations` UserInvitation[], required — List of pending invitations
    - `invitation_id` string, required — Unique identifier for the invitation
    - `inviter` Inviter, required — Model representing the user who sent the invitation. This model contains the details of the user who sent the invitation, including their display name.
      - `name` string, required — Display name of the inviter
    - `invitee` Invitee, required
      - `email` string, required — Email address of the invitee
      - `name` string, required — Display name of the invitee
      - `roles` Role[], required — List of roles to assign to the invitee
        - `role_id` string, required — Name of the role (e.g., 'admin', 'editor', 'viewer')
        - `resource` string, nullable — Optional resource type the role applies to (e.g., 'dataset')
        - `resource_instance` string, nullable — Optional resource instance ID the role applies to
    - `invitation_url` string, required — URL for the user to accept the invitation
    - `created_at` string, required — Timestamp when the invitation was created
    - `expires_at` string, required — Timestamp when the invitation expires
    - `roles` Role[], required — List of roles that will be assigned upon acceptance
      - `role_id` string, required — Name of the role (e.g., 'admin', 'editor', 'viewer')
      - `resource` string, nullable — Optional resource type the role applies to (e.g., 'dataset')
      - `resource_instance` string, nullable — Optional resource instance ID the role applies to
  - `meta` PagedMeta, required — Metadata for paginated responses
    - `page` PagedPageDetails, required — Pagination metadata
      - `current_page` integer, required — Current page number (1-indexed)
      - `last_page` integer, nullable — Last page number (if total is known)
      - `limit` integer, required — Number of items per page
      - `offset` integer, required — Offset of the first item in the current page
      - `total` integer, nullable — Total number of items across all pages
    - `links` PagedLinks, required — Metadata for retrieving paginated data
      - `prev` string, nullable — URL for the previous page
      - `next` string, nullable — URL for the next page
      - `first` string, nullable — URL for the first page
      - `last` string, nullable — URL for the last page
    - `sort` SortItem1[], required — Sort order for the response
      - `direction` 'asc' | 'desc', required — Possible sort orders
      - `field` string, required — Field name to sort by

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/coactive/apis/api-reference.md) · [All operations](https://skmtc.dev/coactive/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coactive/api-reference/revisions/1223758be9ba/schema)