> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-parallel-read-in-order-multi-part.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get list of available organizations

> Returns the organizations available to the caller, oldest first. An API key resolves to the single organization it belongs to; a user token returns every organization the user is a member of. Results are capped at `limit` (default 250) per page; the server may return fewer and caps the value at its own maximum. Every response carries `limit` and `nextCursor`; pass `nextCursor` as the `cursor` query parameter to fetch the next page, repeating until it is null.

Returns the organizations available to the caller, oldest first. An API key resolves to the single organization it belongs to; a user token returns every organization the user is a member of. Results are capped at `limit` (default 250) per page; the server may return fewer and caps the value at its own maximum. Every response carries `limit` and `nextCursor`; pass `nextCursor` as the `cursor` query parameter to fetch the next page, repeating until it is null.


## OpenAPI

````yaml /_specs/cloud-openapi.json get /v1/organizations
openapi: 3.1.1
info:
  title: OpenAPI spec for ClickHouse Cloud
  version: '1.0'
  contact:
    name: ClickHouse Support
    url: >-
      https://clickhouse.com/docs/en/cloud/manage/openapi?referrer=openapi-1234548
    email: support@clickhouse.com
servers:
  - url: https://api.clickhouse.cloud
security:
  - basicAuth: []
tags:
  - name: Organization
  - name: Notifications
  - name: User management
  - name: Billing
  - name: Role Management
  - name: Service
  - name: Backup
  - name: Snapshot
  - name: API keys
  - name: Prometheus
  - name: ClickPipes
  - name: ClickStack
  - name: Postgres
  - name: UDF
  - name: Query API endpoints
  - name: Saved queries
paths:
  /v1/organizations:
    get:
      tags:
        - Organization
      summary: Get list of available organizations
      description: >-
        Returns the organizations available to the caller, oldest first. An API
        key resolves to the single organization it belongs to; a user token
        returns every organization the user is a member of. Results are capped
        at `limit` (default 250) per page; the server may return fewer and caps
        the value at its own maximum. Every response carries `limit` and
        `nextCursor`; pass `nextCursor` as the `cursor` query parameter to fetch
        the next page, repeating until it is null.
      operationId: organizationGetList
      parameters:
        - in: query
          name: limit
          description: Maximum number of results to return.
          schema:
            type: integer
            minimum: 1
            default: 250
        - in: query
          name: cursor
          description: >-
            Opaque cursor from a previous response's `nextCursor`, marking where
            to resume the list.
          schema:
            type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: number
                    description: HTTP status code.
                    example: 200
                  requestId:
                    type: string
                    description: Unique id assigned to every request. UUIDv4
                    format: uuid
                  result:
                    type: array
                    items:
                      $ref: '#/components/schemas/Organization'
                  limit:
                    type: integer
                    description: Maximum number of results returned in this page.
                  nextCursor:
                    type:
                      - string
                      - 'null'
                    description: >-
                      Cursor for the next page, to be sent as the `cursor` query
                      parameter. Null on the last page.
        '400':
          description: >-
            The request cannot be processed due to a client error. Please verify
            your request parameters and try again.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: number
                    description: HTTP status code.
                    example: 400
                  error:
                    type: string
                    description: Detailed error description.
                  requestId:
                    type: string
                    description: Unique id assigned to every request. UUIDv4
                    format: uuid
        '500':
          description: >-
            An internal server error has occurred. If this issue persists,
            please contact ClickHouse Cloud support for assistance.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    description: HTTP status code.
                    example: 500
                  error:
                    type: string
                    description: Detailed error description.
                  requestId:
                    type: string
                    description: Unique id assigned to every request. UUIDv4
                    format: uuid
components:
  schemas:
    Organization:
      properties:
        id:
          description: Unique organization ID.
          type: string
          format: uuid
        createdAt:
          description: The timestamp the organization was created. ISO-8601.
          type: string
          format: date-time
        name:
          description: Name of the organization.
          type: string
        privateEndpoints:
          type: array
          description: List of private endpoints for organization
          items:
            $ref: '#/components/schemas/OrganizationPrivateEndpoint'
        byocConfig:
          type: array
          description: BYOC configuration for the organization
          items:
            $ref: '#/components/schemas/ByocConfig'
        enableCoreDumps:
          description: >-
            Whether crash reports (core dumps) collection is enabled for
            services in the organization. When disabled at the organization
            level, individual services cannot enable crash reports.
          type: boolean
        capabilities:
          $ref: '#/components/schemas/OrganizationCapabilities'
    OrganizationPrivateEndpoint:
      properties:
        id:
          description: Private endpoint identifier
          type: string
        description:
          description: Description of private endpoint
          type: string
        cloudProvider:
          description: Cloud provider in which the private endpoint is lcoated
          type: string
          enum:
            - gcp
            - aws
            - azure
        region:
          description: Region in which the private endpoint is located
          type: string
          enum:
            - ap-northeast-1
            - ap-northeast-2
            - ap-south-1
            - ap-southeast-1
            - ap-southeast-2
            - ca-central-1
            - eu-central-1
            - eu-west-1
            - eu-west-2
            - il-central-1
            - us-east-1
            - us-east-2
            - us-west-2
            - us-east1
            - us-central1
            - europe-west2
            - europe-west4
            - asia-southeast1
            - asia-northeast1
            - eastus
            - eastus2
            - westus3
            - germanywestcentral
            - centralus
    ByocConfig:
      properties:
        id:
          description: Unique identifier of the BYOC configuration
          type: string
        state:
          description: State of the infrastructure
          type: string
          enum:
            - infra-provisioning
            - infra-terminated
            - infra-terminating
            - infra-ready
            - infra-degraded
            - infra-upgrading
          example: infra-ready
        accountId:
          description: >-
            Cloud account ID the BYOC infrastructure is bound to: AWS account
            ID, GCP project ID, or Azure subscription ID
          type: string
          example: '123456789012'
        accountName:
          description: >-
            DEPRECATED. Use `accountId` instead. Cloud account ID the BYOC
            infrastructure is bound to
          type: string
          deprecated: true
        regionId:
          description: >-
            Region for which the BYOC has been configured and where it is
            possible to create services
          type: string
          enum:
            - ap-northeast-1
            - ap-northeast-2
            - ap-south-1
            - ap-southeast-1
            - ap-southeast-2
            - ca-central-1
            - eu-central-1
            - eu-west-1
            - eu-west-2
            - il-central-1
            - us-east-1
            - us-east-2
            - us-west-2
            - us-east1
            - us-central1
            - europe-west2
            - europe-west4
            - asia-southeast1
            - asia-northeast1
            - eastus
            - eastus2
            - westus3
            - germanywestcentral
            - centralus
        cloudProvider:
          description: Cloud provider of the region
          type: string
          enum:
            - gcp
            - aws
            - azure
        displayName:
          description: Human readable name for infrastructure
          type: string
    OrganizationCapabilities:
      properties:
        snapshots:
          description: >-
            Whether the organization is eligible to enable snapshots on its
            primary services.
          type: boolean
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: >-
        Use key ID and key secret obtained in ClickHouse Cloud console:
        https://clickhouse.com/docs/cloud/manage/openapi
      x-permission-scopes: >-
        The scope list of a `security` requirement holds ClickHouse Cloud API
        key permission ids (for example `control-plane:organization:view`), not
        OAuth scopes. OpenAPI has no field for API key permissions, so this is
        the closest available place. A key must hold every permission listed on
        an operation to call it; an operation with no scopes needs none beyond a
        valid key. Every operation declares at most one requirement object,
        always for this scheme, so the list is only ever conjunctive —
        alternative sets of permissions are never expressed.

````