> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pragmatiks.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Organization

> Read any organization's record by id.

Cross-tenant read for support and operations use cases. Gated
identically to :func:`list_organizations` so the same JWKS
boundary keeps the endpoint off-limits to customer principals.
Callers who only need their own organization should hit the
customer-realm ``GET /organizations/me`` instead.

Args:
    organization_id: Clerk organization id to look up.
    user: Authenticated ConsoleUser (unused beyond the gate).
    shared_client: Shared-namespace SurrealDB client.

Returns:
    Organization record.

Raises:
    OrganizationNotFoundError: If no organization has this id.



## OpenAPI

````yaml https://api.pragmatiks.io/openapi.json get /console/organizations/{organization_id}
openapi: 3.1.0
info:
  title: Pragma API
  version: 0.1.0
servers: []
security: []
paths:
  /console/organizations/{organization_id}:
    get:
      tags:
        - console
      summary: Get Organization
      description: |-
        Read any organization's record by id.

        Cross-tenant read for support and operations use cases. Gated
        identically to :func:`list_organizations` so the same JWKS
        boundary keeps the endpoint off-limits to customer principals.
        Callers who only need their own organization should hit the
        customer-realm ``GET /organizations/me`` instead.

        Args:
            organization_id: Clerk organization id to look up.
            user: Authenticated ConsoleUser (unused beyond the gate).
            shared_client: Shared-namespace SurrealDB client.

        Returns:
            Organization record.

        Raises:
            OrganizationNotFoundError: If no organization has this id.
      operationId: console-get_organization
      parameters:
        - name: organization_id
          in: path
          required: true
          schema:
            type: string
            title: Organization Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Organization'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    Organization:
      properties:
        created_at:
          type: string
          format: date-time
          title: Created At
        updated_at:
          type: string
          format: date-time
          title: Updated At
        organization_id:
          type: string
          title: Organization Id
        name:
          type: string
          title: Name
        slug:
          type: string
          title: Slug
        status:
          $ref: '#/components/schemas/OrganizationStatus'
          default: bootstrapping
        bootstrap_error:
          anyOf:
            - type: string
            - type: 'null'
          title: Bootstrap Error
      type: object
      required:
        - organization_id
        - name
        - slug
      title: Organization
      description: |-
        Organization record stored in shared SurrealDB namespace.

        Represents a Clerk organization synced via webhooks. Stored in the
        shared namespace because organization data must be accessible before
        any organization context exists (e.g., during webhook processing).

        Identity fields (frozen):
            organization_id: Clerk organization ID, used as SurrealDB record ID.

        Metadata:
            name: Display name of the organization.
            slug: URL-friendly organization identifier from Clerk.

        State (system-managed):
            status: Lifecycle status.
            bootstrap_error: Short human-readable message set when
                bootstrap fails; cleared on successful retry.

        Inherited from PragmaModel:
            created_at: Creation timestamp (frozen).
            updated_at: Last update timestamp (mutable).
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    OrganizationStatus:
      type: string
      enum:
        - bootstrapping
        - ready
        - bootstrap_failed
        - deactivating
        - deleted
      title: OrganizationStatus
      description: |-
        Lifecycle status of an organization.

        Bootstrap states:
            BOOTSTRAPPING: Organization row exists, bootstrap worker has not
                yet finished provisioning tenant namespace resources.
            READY: Organization is fully provisioned and usable.
            BOOTSTRAP_FAILED: Bootstrap worker exhausted its retry budget.
                Recovery is manual during private beta: operators contact
                support or clear the failure via direct SurrealDB
                intervention.

        Teardown states:
            DEACTIVATING: Cleanup worker is tearing down tenant resources.
            DELETED: Organization fully cleaned up.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````