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

# List organizations

> Lists active organizations in CodeRabbit. Organization API keys return their bound organization; workspace API keys return all active organizations in the workspace. Enterprise plan only.

export const EnterprisePlanBadge = ({tip = "This feature is available exclusively as part of the Enterprise plan. Please refer to our pricing page for more information about our plans and features.", title = "Enterprise Plan", cta = "Read more", href = "https://coderabbit.ai/pricing", disabled = false}) => {
  return <Tooltip tip={tip} cta={cta} href={href}>
        <Badge icon="building-2" disabled={disabled || undefined}>
            {title}
        </Badge>
    </Tooltip>;
};

<EnterprisePlanBadge />

Use this endpoint to discover the CodeRabbit organization IDs available to the current API key before calling organization-scoped endpoints. A workspace API token returns every active organization in its workspace, while an organization-scoped API key returns only its bound organization.

The returned `id` is a CodeRabbit organization UUID. It differs from `provider_organization_id`, which is assigned by the Git provider.


## OpenAPI

````yaml get /v1/organizations
openapi: 3.0.3
info:
  title: CodeRabbit API spec
  version: 1.0.0
servers:
  - url: https://api.coderabbit.ai
security:
  - ApiKeyAuth: []
paths:
  /v1/organizations:
    get:
      tags:
        - Organizations
      summary: List onboarded organizations
      description: >-
        Lists active organizations in CodeRabbit. Organization API keys return
        their bound organization; workspace API keys return all active
        organizations in the workspace. Enterprise plan only.
      operationId: organizations-list
      parameters:
        - in: header
          name: x-coderabbitai-api-key
          required: true
          schema:
            type: string
          description: User-scoped organization or workspace API key.
        - in: query
          name: limit
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 100
        - in: query
          name: cursor
          schema:
            type: string
          description: Opaque pagination cursor returned by the previous page.
      responses:
        '200':
          description: Successfully listed onboarded organizations.
          content:
            application/json:
              schema:
                type: object
                required:
                  - organizations
                  - next_cursor
                properties:
                  organizations:
                    type: array
                    items:
                      type: object
                      required:
                        - id
                        - name
                        - provider
                        - provider_organization_id
                      properties:
                        id:
                          type: string
                          format: uuid
                          description: >-
                            CodeRabbit organization ID used by nested
                            organization endpoints.
                        name:
                          type: string
                        provider:
                          type: string
                          example: github
                        provider_organization_id:
                          type: string
                          description: >-
                            Organization identifier assigned by the git
                            provider.
                  next_cursor:
                    type: string
                    nullable: true
        '400':
          description: Invalid pagination parameters.
        '401':
          description: Invalid or inactive API key.
        '403':
          description: >-
            Enterprise plan, workspace administrator, key type, or RBAC
            requirement not met.
        '410':
          description: Legacy organization API key.
        '429':
          description: Rate limit exceeded.
        '500':
          description: Internal server error.
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-coderabbitai-api-key
      description: >-
        API key for authentication. You can create an API key from the
        CodeRabbit dashboard.

````