---
title: "List pending invites"
method: GET
path: "/api/v1/orgs/{slug}/invites"
tags: ["Org Members & Invites"]
---

# List pending invites

`GET /api/v1/orgs/{slug}/invites`

## Request

- Base URL: `https://api.skills-hub.ai`
- URL: `https://api.skills-hub.ai/api/v1/orgs/{slug}/invites`
- Auth: one of:
  - HTTP bearer
  - API key in header `Authorization`

Returns the organization's pending invites with invitee, role, inviter, target unit, and expiry. Invite tokens are omitted from the list (they are only returned when the invite is created). Requires the `ADMIN` org role.

## Path parameters

- `slug` string, required

## Response `200`

Successful response. The returned fields are described in this endpoint's summary/description; typed per-field response schemas are being added incrementally.

- object[]
  - `id` string
  - `token` string: Empty in list responses; only returned on invite creation.
  - `inviteeUsername` string, nullable
  - `inviteeEmail` string, nullable
  - `role` 'ADMIN' | 'PUBLISHER' | 'MEMBER'
  - `status` 'PENDING' | 'ACCEPTED' | 'DECLINED' | 'EXPIRED'
  - `invitedBy` string
  - `department` string, nullable
  - `team` string, nullable
  - `expiresAt` string, date-time
  - `createdAt` string, date-time

---

[API](https://skmtc.dev/skills-hub/apis/skills-hub-ai-api.md) · [All operations](https://skmtc.dev/skills-hub/apis/skills-hub-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/skills-hub/apis/skills-hub-ai-api/revisions/cb5d46d80300?raw)
