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

# Get Organization

> Get Organization



## OpenAPI

````yaml /api-reference/openapi.json get /organizations/{organizationId}
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/{organizationId}:
    get:
      parameters:
        - in: path
          name: organizationId
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Organization'
          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:
    Organization:
      title: organization
      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
    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

````