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

# List Organizations

> List Organizations



## OpenAPI

````yaml /api-reference/openapi.json get /organizations
openapi: 3.1.0
info:
  title: Cradl API
  version: '2026-01-28T09:00:46Z'
servers:
  - url: https://api.cradl.ai/{basePath}
    variables:
      basePath:
        default: v1
security: []
paths:
  /organizations:
    get:
      parameters:
        - in: query
          name: nextToken
          schema:
            type: string
        - in: query
          name: maxResults
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Organizations'
          description: 200 response
          headers:
            Access-Control-Allow-Headers:
              schema:
                type: string
            Access-Control-Allow-Origin:
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: 400 response
          headers:
            Access-Control-Allow-Headers:
              schema:
                type: string
            Access-Control-Allow-Origin:
              schema:
                type: string
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: 403 response
          headers:
            Access-Control-Allow-Headers:
              schema:
                type: string
            Access-Control-Allow-Origin:
              schema:
                type: string
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: 404 response
          headers:
            Access-Control-Allow-Headers:
              schema:
                type: string
            Access-Control-Allow-Origin:
              schema:
                type: string
        '415':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: 415 response
          headers:
            Access-Control-Allow-Headers:
              schema:
                type: string
            Access-Control-Allow-Origin:
              schema:
                type: string
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: 500 response
          headers:
            Access-Control-Allow-Headers:
              schema:
                type: string
            Access-Control-Allow-Origin:
              schema:
                type: string
      security:
        - OAuth2:
            - organizations:read
components:
  schemas:
    Organizations:
      title: organizations
      required:
        - nextToken
        - organizations
      type: object
      properties:
        nextToken:
          maxLength: 4096
          type: string
          nullable: true
        organizations:
          type: array
          items:
            required:
              - createdBy
              - createdTime
              - description
              - documentRetentionInDays
              - metadata
              - monthlyNumberOfActiveModelsUsed
              - monthlyNumberOfDataBundlesAllowed
              - monthlyNumberOfDataBundlesCreated
              - monthlyNumberOfDocumentsAllowed
              - monthlyNumberOfDocumentsCreated
              - monthlyNumberOfFieldPredictionsAllowed
              - monthlyNumberOfFieldPredictionsUsed
              - monthlyNumberOfGpuHoursUsed
              - monthlyNumberOfPredictionsAllowed
              - monthlyNumberOfPredictionsCreated
              - monthlyNumberOfTrainingsAllowed
              - monthlyNumberOfTrainingsCreated
              - monthlyNumberOfTransformationsAllowed
              - monthlyNumberOfTransformationsCreated
              - monthlyNumberOfTransitionExecutionsAllowed
              - monthlyNumberOfTransitionExecutionsCreated
              - monthlyNumberOfWorkflowExecutionsAllowed
              - monthlyNumberOfWorkflowExecutionsCreated
              - monthlyUsageSummary
              - name
              - numberOfAppClientsAllowed
              - numberOfAppClientsCreated
              - numberOfAssetsAllowed
              - numberOfAssetsCreated
              - numberOfModelsAllowed
              - numberOfModelsCreated
              - numberOfSecretsAllowed
              - numberOfSecretsCreated
              - numberOfTransitionsAllowed
              - numberOfTransitionsCreated
              - numberOfUsersAllowed
              - numberOfUsersCreated
              - numberOfWorkflowsAllowed
              - numberOfWorkflowsCreated
              - organizationId
              - paymentMethodId
              - planId
              - updatedBy
              - updatedTime
            type: object
            properties:
              numberOfAgentsCreated:
                minimum: 0
                type: integer
              privileges:
                type: object
              metadata:
                type: object
                nullable: true
              monthlyNumberOfAgentRunsCreated:
                minimum: 0
                type: integer
              deploymentsAllowed:
                type: object
              monthlyNumberOfHookRunsCreated:
                minimum: 0
                type: integer
              numberOfHooksCreated:
                minimum: 0
                type: integer
              numberOfUsersAllowed:
                minimum: 0
                type: integer
              monthlyNumberOfPredictionsAllowed:
                minimum: 0
                type: integer
              numberOfDatasetsAllowed:
                minimum: 0
                type: integer
              organizationId:
                pattern: ^(cradl|las):organization:[a-z0-9-_]+$
                type: string
              numberOfModelsCreated:
                minimum: 0
                type: integer
              numberOfTransitionsCreated:
                minimum: 0
                type: integer
              monthlyNumberOfDocumentsAllowed:
                minimum: 0
                type: integer
              numberOfActionsCreated:
                minimum: 0
                type: integer
              monthlyNumberOfActionRunsAllowed:
                minimum: 0
                type: integer
              monthlyNumberOfTransformationsCreated:
                minimum: 0
                type: integer
              createdTime:
                pattern: >-
                  ^[0-9]{4}-?[0-9]{2}-?[0-9]{2}(
                  |T)?[0-9]{2}:?[0-9]{2}:?[0-9]{2}(.[0-9]{1,6})?(Z|[+][0-9]{2}(:|)[0-9]{2})$
                type: string
              planId:
                pattern: >-
                  ^(|(cradl|las):organization:[a-z0-9-_]+/)(cradl|las):plan:[a-z0-9-_]+(|:@[a-z0-9-_]+|:[0-9]+)$
                type: string
                nullable: true
              monthlyNumberOfValidationTasksCreated:
                minimum: 0
                type: integer
              monthlyUsageSummary:
                type: object
              updatedTime:
                pattern: >-
                  ^[0-9]{4}-?[0-9]{2}-?[0-9]{2}(
                  |T)?[0-9]{2}:?[0-9]{2}:?[0-9]{2}(.[0-9]{1,6})?(Z|[+][0-9]{2}(:|)[0-9]{2})$
                type: string
                nullable: true
              monthlyNumberOfPagePredictionsAllowed:
                minimum: 0
                type: integer
              deploymentsCreated:
                type: object
              monthlyNumberOfGpuHoursUsed:
                minimum: 0
                type: number
              updatedBy:
                maxLength: 4096
                type: string
                nullable: true
              numberOfAgentsAllowed:
                minimum: 0
                type: integer
              monthlyNumberOfAgentRunsAllowed:
                minimum: 0
                type: integer
              monthlyNumberOfWorkflowExecutionsAllowed:
                minimum: 0
                type: integer
              monthlyNumberOfActiveModelsUsed:
                minimum: 0
                type: integer
              pictureUrl:
                pattern: ^http://localhost.*|^https://.*
                type: string
                nullable: true
              monthlyNumberOfDataBundlesCreated:
                minimum: 0
                type: integer
              numberOfUsersCreated:
                minimum: 0
                type: integer
              monthlyNumberOfActionRunsCreated:
                minimum: 0
                type: integer
              monthlyNumberOfTransitionExecutionsCreated:
                minimum: 0
                type: integer
              numberOfActionsAllowed:
                minimum: 0
                type: integer
              numberOfSecretsCreated:
                minimum: 0
                type: integer
              numberOfValidationsCreated:
                minimum: 0
                type: integer
              name:
                maxLength: 4096
                type: string
                nullable: true
              monthlyNumberOfTransformationsAllowed:
                minimum: 0
                type: integer
              monthlyNumberOfProductionWorkflowMinutesUsed:
                minimum: 0
                type: integer
              numberOfAppClientsAllowed:
                minimum: 0
                type: integer
              code:
                maxLength: 4096
                type: string
                nullable: true
              numberOfWorkflowsCreated:
                minimum: 0
                type: integer
              monthlyNumberOfFieldPredictionsUsed:
                minimum: 0
                type: integer
              monthlyNumberOfWorkflowExecutionsCreated:
                minimum: 0
                type: integer
              description:
                maxLength: 4096
                type: string
                nullable: true
              monthlyNumberOfDataBundlesAllowed:
                minimum: 0
                type: integer
              monthlyNumberOfTransitionExecutionsAllowed:
                minimum: 0
                type: integer
              numberOfSecretsAllowed:
                minimum: 0
                type: integer
              monthlyNumberOfTrainingsCreated:
                minimum: 0
                type: integer
              monthlyNumberOfUserMinutesUsed:
                minimum: 0
                type: number
              numberOfValidationsAllowed:
                minimum: 0
                type: integer
              paymentMethodId:
                pattern: ^(cradl|las):payment-method:[a-f0-9]{32}$
                type: string
                nullable: true
              monthlyNumberOfModelDeploymentUnitsUsed:
                minimum: 0
                type: integer
              numberOfAppClientsCreated:
                minimum: 0
                type: integer
              numberOfAssetsCreated:
                minimum: 0
                type: integer
              numberOfWorkflowsAllowed:
                minimum: 0
                type: integer
              clientId:
                pattern: ^[0-9a-z]+$
                type: string
                nullable: true
              documentRetentionInDays:
                maximum: 1825
                minimum: 1
                type: integer
              numberOfConnectionsAllowed:
                minimum: 0
                type: integer
              numberOfHooksAllowed:
                minimum: 0
                type: integer
              monthlyNumberOfHookRunsAllowed:
                minimum: 0
                type: integer
              monthlyNumberOfPredictionsCreated:
                minimum: 0
                type: integer
              url:
                maxLength: 4096
                type: string
                nullable: true
              numberOfDatasetsCreated:
                minimum: 0
                type: integer
              monthlyNumberOfPagePredictionsUsed:
                minimum: 0
                type: integer
              numberOfTransitionsAllowed:
                minimum: 0
                type: integer
              monthlyNumberOfDocumentsCreated:
                minimum: 0
                type: integer
              numberOfConnectionsCreated:
                minimum: 0
                type: integer
              numberOfModelsAllowed:
                minimum: 0
                type: integer
              createdBy:
                maxLength: 4096
                type: string
              monthlyNumberOfTrainingsAllowed:
                minimum: 0
                type: integer
              monthlyNumberOfFieldPredictionsAllowed:
                minimum: 0
                type: integer
              monthlyNumberOfValidationTasksAllowed:
                minimum: 0
                type: integer
              useNewScopes:
                type: boolean
              numberOfAssetsAllowed:
                minimum: 0
                type: integer
            additionalProperties: false
      additionalProperties: false
    Error:
      title: Error Schema
      type: object
      properties:
        message:
          type: string
  securitySchemes:
    OAuth2:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://auth.cradl.ai/oauth2/token
          scopes:
            actions.runs:read: Read permissions
            actions.runs:write: Write permissions
            actions:read: Read permissions
            actions:write: Write permissions
            agents.runs:read: Read permissions
            agents.runs:write: Write permissions
            agents.statistics:read: Read permissions
            agents:read: Read permissions
            agents:write: Write permissions
            appclients:read: Read permissions
            appclients:write: Write permissions
            documents:read: Read permissions
            documents:write: Write permissions
            hooks.runs:read: Read permissions
            hooks.runs:write: Write permissions
            hooks:read: Read permissions
            hooks:write: Write permissions
            logs:read: Read permissions
            models:read: Read permissions
            models:write: Write permissions
            organizations:read: Read permissions
            organizations:write: Write permissions
            predictions:read: Read permissions
            predictions:write: Write permissions
            users:read: Read permissions
            users:write: Write permissions
            validations.tasks:read: Read permissions
            validations.tasks:write: Write permissions
            validations:read: Read permissions
            validations:write: Write permissions
            workflows:read: Read permissions
            workflows:write: Write permissions

````