# Returns a paginated list of invitations for the current tenant.

Required IAM actions (all required, on scope /): tenant.subjects.manage

Endpoint: GET /v1/invitations
Version: 1
Security: authorization_code_with_pkce, client_credentials

## Query parameters:

  - `status` (string)
    Enum: "Pending", "PendingEnrollment", "Processing", "Accepted", "Cancelled", "Expired"

  - `page` (integer)
    Requested page

  - `pageSize` (integer)
    Requested pagesize

## Response 200 fields (application/json):

  - `items` (array, required)
    The items on the current page.

  - `items.id` (string, required)

  - `items.email` (string, required)

  - `items.status` (string, required)
    Enum: "Pending", "PendingEnrollment", "Processing", "Accepted", "Cancelled", "Expired"

  - `items.createdAt` (string, required)

  - `items.expiresAt` (string, required)

  - `items.acceptedAt` (string,null)

  - `items.permissions` (array, required)

  - `items.permissions.action` (string, required)

  - `items.permissions.scope` (string, required)

  - `items.redirectUri` (string,null)

  - `items.inviterName` (string,null)

  - `metadata` (object, required)
    Pagination details such as current page, page size, and total count.

  - `metadata.page` (integer, required)
    The current page number (1-based).

  - `metadata.pageSize` (integer, required)
    The number of items per page.

  - `metadata.totalCount` (integer, required)
    The total number of items across all pages.

  - `links` (object, required)
    Navigation links for first, previous, next, and last pages.

  - `links.first` (string,null)
    Link to the first page.

  - `links.previous` (string,null)
    Link to the previous page, if one exists.

  - `links.next` (string,null)
    Link to the next page, if one exists.

  - `links.last` (string,null)
    Link to the last page.


## Response 401 fields

## Response 403 fields