GET/organizations/{organization_id}/invitations/pendingDeprecated

Get a list of pending organization invitations

This request returns the list of organization invitations with "pending" status. These are the organization invitations that can still be used to join the organization, but have not been accepted by the invited user yet. Results can be paginated using the optional limit and offset query parameters. The organization invitations are ordered by descending creation date. Most recent invitations will be returned first. Any invitations created as a result of an Organization Domain are not included in the results.

3 parameters

organization_idstringrequired

The organization ID.

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

3 status codes

200A list of organization invitations

dataarray<object>required

total_countintegerrequired

Total number of organization invitations

400Request 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 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.pending.list({
  organizationId: "9b2f1c10-7a3e-4d54-8c2a-1f6b9e0d4a21",
  limit: 20,
  offset: 0,
});

{
  "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"
    }
  ],
  "total_count": 42
}

Request

Response

Errors