Retrieve an organization role | Clerk API (unofficial showcase)

1 parameter

organization_role_idstringrequired

The ID of the organization role

4 status codes

200Success

objectstringrequired

Allowed:role

idstringrequired

namestringrequired

keystringrequired

descriptionstringrequired

is_creator_eligiblebooleanrequired

Whether this role is eligible to be an organization creator role

permissionsarray<object>required

created_atintegerrequired

Unix timestamp of creation.

updated_atintegerrequired

Unix timestamp of last update.

401Authentication invalid

errorsarray<object>required

metaobjectoptional

clerk_trace_idstringoptional

403Authorization invalid

errorsarray<object>required

metaobjectoptional

clerk_trace_idstringoptional

404Resource not found

errorsarray<object>required

metaobjectoptional

clerk_trace_idstringoptional

Error handling

A 401 is returned: Authentication invalid. A 403 is returned: Authorization invalid. 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.organizationRoles.get({ organizationRoleId: "3fa85f64-5717-4562-b3fc-2c963f66afa6" });

{
  "object": "role",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Example Name",
  "key": "example_key_abc123",
  "description": "Example description",
  "is_creator_eligible": true,
  "permissions": [
    {
      "object": "permission",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Example Name",
      "key": "example_key_abc123",
      "description": "Example description",
      "type": "standard",
      "created_at": 1,
      "updated_at": "2026-01-15T09:00:00Z"
    }
  ],
  "created_at": 1,
  "updated_at": "2026-01-15T09:00:00Z"
}

Request

Response

Errors