---
title: "List pending team invitations"
method: GET
path: "/team_invitations"
tags: ["Team"]
---

# List pending team invitations

`GET /team_invitations`

## Request

- Base URL: `https://api.llmpulse.ai/api/v1`
- URL: `https://api.llmpulse.ai/api/v1/team_invitations`
- Auth: API key in header `Authorization`

Lists invitations that have not been accepted yet: the address, the access and projects the person will get, when the invitation was sent and when its link expires. An accepted invitation keeps its id and moves to GET /team_members. Same access rules as GET /team_members.

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

OK

- object
  - `page` integer
  - `per_page` integer
  - `total` integer
  - `data` TeamInvitation[]
    - `id` integer, required: Kept by the member once they accept, when they move to GET /team_members.
    - `email` string, required
    - `permission_role` 'full_access' | 'view_only' | 'custom' | 'account_role', required
    - `account_role` TeamAccountRole, nullable, required: The account role the person follows, when permission_role is account_role; null otherwise.
      - `id` integer, required
      - `name` string, required
    - `permissions` TeamPermissions, nullable, required: What the person can do, feature key to the verbs granted (read, create, update, delete), resolved from their role. Null for the account owner, who can do everything.
    - `account_admin` boolean, required
    - `billing_access` boolean, required
    - `all_projects` boolean, required
    - `project_ids` integer[], required
    - `invited_at` string, date-time, nullable: When the invitation email was last sent.
    - `expires_at` string, date-time, nullable: When the invitation link stops working.
    - `created_at` string, date-time
  - `request_id` string

## Other responses

- `401`: Authentication failed
- `403`: A key limited to some projects answers ERR_KEY_PROJECT_SCOPED, since the team belongs to the whole account. A team member without the Team Members permission, or asking for something only the owner or a co-owner can do, answers ERR_INSUFFICIENT_PERMISSION, and a write with a read-only key ERR_INSUFFICIENT_SCOPE, with the same status

## Changes

- **2026-10-11** `82f2d44c22e5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/llmpulse/apis/llm-pulse-api/changes/team_invitations/get.md)

---

[API](https://skmtc.dev/llmpulse/apis/llm-pulse-api.md) - [All operations](https://skmtc.dev/llmpulse/apis/llm-pulse-api/llms.txt) - [OpenAPI document](https://skmtc.dev/llmpulse/apis/llm-pulse-api/revisions/38a31f123641?raw)