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

# Get organization information

> Retrieve information about the current user's organization including name, members, and balance.

**Organization Ownership Model:**
TensorPool supports both individual user accounts and organization accounts.

**Key Concepts:**
- **Individual Resources**: Owned by a single user (uid)
- **Organization Resources**: Owned by an organization (org_id), shared by all members
- **Shared Balance**: Organization members share the organization's balance
- **Shared Access**: All organization members can view and use organization-owned resources (clusters, jobs, storage, SSH keys)
- **Admin Permissions**: Only admins can add/invite members and manage organization settings

**Resource Listing:**
Most list endpoints (e.g., `/cluster/list`, `/job/list`, `/storage/list`) support `?include_org=true` query parameter to list organization-owned resources instead of personal resources.



## OpenAPI

````yaml https://engine.tensorpool.dev/openapi.json get /user/organization/info
openapi: 3.1.0
info:
  title: TensorPool API
  description: >
    TensorPool API


    All API endpoints (except `/healthz`) require authentication using your
    TensorPool API key.


    ### For REST Endpoints


    Include your API key in the `Authorization` header as a Bearer token:


    ```bash

    Authorization: Bearer YOUR_TENSORPOOL_KEY

    ```

    ### For WebSocket Endpoints


    Send your API key as the first message in JSON format:


    ```json

    {"TENSORPOOL_KEY": "YOUR_TENSORPOOL_KEY"}

    ```
  version: 0.1.0
servers: []
security: []
tags:
  - name: job
    description: >-
      GPU job execution and management. Run workloads on ephemeral clusters with
      automatic cleanup.
  - name: cluster
    description: >-
      GPU cluster provisioning and lifecycle management. Create persistent
      compute resources.
  - name: storage
    description: >-
      Shared storage volume management. Persistent storage that can be attached
      to eligible clusters.
  - name: object-storage
    description: S3-compatible object storage management.
  - name: ssh
    description: SSH key management for secure cluster access.
  - name: user
    description: >-
      User account management including balance, billing, and organization
      operations.
  - name: requests
    description: Cloud resource provisioning request tracking and status monitoring.
paths:
  /user/organization/info:
    get:
      tags:
        - user
      summary: Get organization information
      description: >-
        Retrieve information about the current user's organization including
        name, members, and balance.


        **Organization Ownership Model:**

        TensorPool supports both individual user accounts and organization
        accounts.


        **Key Concepts:**

        - **Individual Resources**: Owned by a single user (uid)

        - **Organization Resources**: Owned by an organization (org_id), shared
        by all members

        - **Shared Balance**: Organization members share the organization's
        balance

        - **Shared Access**: All organization members can view and use
        organization-owned resources (clusters, jobs, storage, SSH keys)

        - **Admin Permissions**: Only admins can add/invite members and manage
        organization settings


        **Resource Listing:**

        Most list endpoints (e.g., `/cluster/list`, `/job/list`,
        `/storage/list`) support `?include_org=true` query parameter to list
        organization-owned resources instead of personal resources.
      operationId: get_organization_info_user_organization_info_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrganizationInfoResponse'
      security:
        - HTTPBearer: []
components:
  schemas:
    OrganizationInfoResponse:
      properties:
        org_name:
          type: string
          title: Org Name
          description: Organization name
        members:
          items:
            $ref: '#/components/schemas/OrganizationMember'
          type: array
          title: Members
          description: List of organization members
        balance:
          type: number
          title: Balance
          description: Organization balance in USD
      type: object
      required:
        - org_name
        - members
        - balance
      title: OrganizationInfoResponse
      description: Response model for GET /user/organization/info endpoint.
    OrganizationMember:
      properties:
        uid:
          type: string
          title: Uid
          description: User ID
        email:
          type: string
          title: Email
          description: User email address
      type: object
      required:
        - uid
        - email
      title: OrganizationMember
      description: Model for an organization member.
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````