Retrieve all invitations for a user | Clerk API (unofficial showcase)

4 parameters

user_idstringrequired

The ID of the user whose organization invitations we want to retrieve

limitintegeroptional

Applies a limit to the number of results returned. Can be used for paginating the results together with `offset`.

Default:10

offsetintegeroptional

Skip the first `offset` results when paginating. Needs to be an integer greater or equal to zero. To be used in conjunction with `limit`.

Default:0

statusstringoptional

Filter organization invitations based on their status

Allowed:pendingacceptedrevokedexpired

4 status codes

200A list of organization invitations with public organization data

dataarray<object>required

total_countintegerrequired

Total number of organization invitations

400Request was not successful

errorsarray<object>required

metaobjectoptional

clerk_trace_idstringoptional

403Request was not successful

errorsarray<object>required

metaobjectoptional

clerk_trace_idstringoptional

404Resource not found

errorsarray<object>required

metaobjectoptional

clerk_trace_idstringoptional

Error handling

A 400 is returned: Request was not successful. A 403 is returned: Request was not successful. A 404 is returned: Resource not found.

import { Client } from "@octridev/clerk";

const client = new Client({
  baseUrl: "https://api.clerk.com/v1",
  auth: { bearer: process.env.API_TOKEN },
});

const result = await client.organizationInvitations.list({
  userId: "c0a80123-4567-89ab-cdef-0123456789ab",
  limit: 20,
  offset: 0,
  status: "example",
});

{
  "data": [
    {
      "object": "organization_invitation",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "email_address": "user@example.com",
      "role": "administrator",
      "role_name": "Example Name",
      "organization_id": "550e8400-e29b-41d4-a716-446655440000",
      "inviter_id": "550e8400-e29b-41d4-a716-446655440000",
      "public_inviter_data": {
        "user_id": "550e8400-e29b-41d4-a716-446655440000",
        "first_name": "Example Name",
        "last_name": "Example Name",
        "image_url": "https://example.com",
        "has_image": true,
        "identifier": "example_value"
      },
      "status": "active",
      "url": "https://example.com",
      "expires_at": 1,
      "created_at": 1,
      "updated_at": "2026-01-15T09:00:00Z",
      "public_organization_data": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "Example Name",
        "slug": "my-example-resource",
        "image_url": "https://example.com",
        "has_image": true
      }
    }
  ],
  "total_count": 42
}

Request

Response

Errors