> ## 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 onboarded 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.

> [tab] CLI Tool
>
> ```bash
> coderabbit api request /organizations
> ```
>
> To install and sign in to the CLI, see [Call from the CLI](https://docs.coderabbit.ai/api/cli.md).

> [tab] MCP Server
>
> This operation isn't a tool on the [CodeRabbit MCP server](https://docs.coderabbit.ai/api/mcp.md). Call it over REST or from the CLI.


## OpenAPI

````yaml /openapi.json get /v1/organizations
openapi: 3.0.0
info:
  title: CodeRabbit API
  version: 1.0.0
  description: >-
    Read and manage CodeRabbit reviews, coding tasks, Verify, Triage, security
    findings, Knowledge Base, configuration, and users for your organization.
servers:
  - url: https://api.coderabbit.ai
    description: US region
  - url: https://api.eu.coderabbit.ai
    description: EU region
security:
  - ApiKeyAuth: []
tags:
  - name: Organizations and repositories
  - name: Pull requests and reviews
  - name: Coding Agent
  - name: Coding environments
  - name: Verify
  - name: Triage
  - name: Security
  - name: Knowledge Base
  - name: Automations
  - name: Reports
  - name: Configuration
  - name: Connections
  - name: Users and roles
  - name: Usage and metrics
paths:
  /v1/organizations:
    get:
      tags:
        - Organizations and repositories
      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: 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: >-
        See [Authentication](/api/authentication) for the key types and where to
        create a key.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.