---
title: "List all invitations"
method: GET
path: "/invitations"
tags: ["Invitations"]
---

# List all invitations

`GET /invitations`

Returns all non-revoked invitations for your application, sorted by creation date

## Query parameters

- `status` 'pending' | 'accepted' | 'revoked' | 'expired'
- `query` string
- `order_by` string
- `paginated` boolean
- `limit` integer
- `offset` integer

## Response `200`

List of invitations

- Invitation[]
  - `object` 'invitation', required
  - `id` string, required
  - `email_address` string, email, required
  - `public_metadata` object, required
  - `revoked` boolean
  - `status` 'pending' | 'accepted' | 'revoked' | 'expired', required
  - `url` string
  - `expires_at` integer, nullable — Unix timestamp of expiration.
  - `created_at` integer, required — Unix timestamp of creation.
  - `updated_at` integer, required — Unix timestamp of last update.

---

[API](https://skmtc.net/clerk/apis/clerk-backend-api.md) · [All operations](https://skmtc.net/clerk/apis/clerk-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clerk/clerk-backend-api/revisions/cf036e7951d3/schema)