Get an organization permission | Clerk API (unofficial showcase)

1 parameter

permission_idstringrequired

The ID of the permission to retrieve

3 status codes

200Success

objectstringrequired

Allowed:permission

idstringrequired

namestringrequired

keystringrequired

descriptionstringrequired

typestringrequired

created_atintegerrequired

Unix timestamp of creation.

updated_atintegerrequired

Unix timestamp of last update.

401Authentication 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 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.organizationPermissions.get({ permissionId: "3fa85f64-5717-4562-b3fc-2c963f66afa6" });

{
  "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"
}

Request

Response

Errors