---
title: "List pending invitations."
method: GET
path: "/v1/org/invitations"
tags: ["org"]
---

# List pending invitations.

`GET /v1/org/invitations`

## Request

- Base URL: `https://api.smolmachines.com`
- URL: `https://api.smolmachines.com/v1/org/invitations`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/smolmachines/apis/smolfleet-api/docs/v1/org/invitations/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the organization's invitations that have not been accepted. Requires the `members:write` scope (owner or admin).

## Response `200`

The invitations this organization still waits on, oldest first, without their tokens.

- OrgInvitation[]
  - `createdAt` string, required
  - `email` string, required: The address invited, lowercased the way it is matched at acceptance.
  - `expiresAt` string, required: When it lapses. After this it is neither listed nor acceptable.
  - `id` string, required
  - `invitedBy` string, required: The account id of the person who sent it.
  - `role` string, required: The role the membership row will carry: `owner`, `admin` or `member`.

## Other responses

- `401`: Missing or invalid API key
- `403`: Reading the pending list is an owner or admin action
- `422`: An individual account, not an organization
- `429`: Rate limited; retry after the Retry-After header
- `500`: Internal error

## Changes

- **2026-10-16** `bc31fc04a568`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/smolmachines/apis/smolfleet-api/changes/v1/org/invitations/get.md)

---

[API](https://skmtc.dev/smolmachines/apis/smolfleet-api.md) - [All operations](https://skmtc.dev/smolmachines/apis/smolfleet-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smolmachines/apis/smolfleet-api/revisions/bc31fc04a568?raw)