Organizations

Retrieve an organization by ID or slug

Changed on

Fetches the organization whose ID or slug matches the provided id_or_slug URL query parameter.

get/organizations/{organization_id}

Request

  • Base URL: https://api.clerk.com/v1
  • URL: https://api.clerk.com/v1/organizations/{organization_id}
  • Auth: HTTP bearer

Path parameters

organization_idstring required

The ID or slug of the organization

Query parameters

include_members_countboolean

Flag to denote whether or not the organization's members count should be included in the response.

include_missing_member_with_elevated_permissionsboolean

Flag to denote whether or not to include a member with elevated permissions who is not currently a member of the organization.

Response

An organization

object'organization' required
idstring required
namestring required
slugstring required
image_urlstring
has_imageboolean required
members_countinteger
missing_member_with_elevated_permissionsboolean
pending_invitations_countinteger
max_allowed_membershipsinteger required
admin_delete_enabledboolean required
self_serve_sso_enabledboolean

Whether this organization can configure self-serve enterprise SSO.

public_metadataobject required
private_metadataobject
created_bystring
created_atinteger required

Unix timestamp of creation.

updated_atinteger required

Unix timestamp of last update.

last_active_atinteger

Unix timestamp of last activity.

role_set_keystring nullable

The key of the role set assigned to this organization.

Changes

  • 2025-11-10a490313abffaRevision changes
    • warning

      removed the optional property from the response with the status

  • 2025-11-107db12d6a9b2aRevision changes
    • info

      added the optional property to the response with the status