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

# Query the cluster assets that back allocation

> Returns the nodes and disks billed over the window, in OpenCost's asset shape. Load balancers are not reported.



## OpenAPI

````yaml /api-reference/costgraph/openapi.json get /api/v1/tenant/opencost/assets
openapi: 3.0.0
info:
  description: Read and manage your CostGraph organization, spend, alerts, and settings.
  title: CostGraph API
  contact: {}
  version: '1.0'
servers:
  - url: https://api.costgraph.ai
security: []
tags:
  - name: ai
    x-group: AI
  - name: ai-serving
    x-group: AI serving
  - name: anomalies
    x-group: Anomalies
  - name: auth
    x-group: Auth
  - name: billing
    x-group: Billing
  - name: billing-export
    x-group: Billing export
  - name: budgets
    x-group: Budgets
  - name: ci
    x-group: CI
  - name: compute-recommendations
    x-group: Compute recommendations
  - name: config
    x-group: Config
  - name: cost
    x-group: Cost
  - name: gpus
    x-group: GPUs
  - name: graphai
    x-group: Graph AI
  - name: infracost
    x-group: Infracost
  - name: integrations
    x-group: Integrations
  - name: invitations
    x-group: Invitations
  - name: kubernetes-clusters
    x-group: Kubernetes clusters
  - name: marketplace
    x-group: Marketplace
  - name: network-requests
    x-group: Network requests
  - name: notifications
    x-group: Notifications
  - name: oauth
    x-group: OAuth
  - name: oauth-clients
    x-group: OAuth clients
  - name: opencost
    x-group: OpenCost
  - name: organization
    x-group: Audit log
  - name: organizations
    x-group: Organizations
  - name: placement-alternatives
    x-group: Placement alternatives
  - name: reports
    x-group: Reports
  - name: service-map
    x-group: Service map
  - name: settings
    x-group: Settings
  - name: sso
    x-group: Single sign-on
  - name: tenants
    x-group: Tenants
  - name: user
    x-group: Users
  - name: virtual-machines
    x-group: Virtual machines
  - name: virtual-tags
    x-group: Virtual tags
  - name: workflows
    x-group: Workflows
paths:
  /api/v1/tenant/opencost/assets:
    get:
      tags:
        - opencost
      summary: Query the cluster assets that back allocation
      description: >-
        Returns the nodes and disks billed over the window, in OpenCost's asset
        shape. Load balancers are not reported.
      parameters:
        - description: >-
            Duration (7d, 24h), 'today', 'yesterday', or a comma-separated
            RFC3339 pair
          name: window
          in: query
          required: true
          schema:
            type: string
        - description: Duration of each returned set; defaults to the whole window
          name: step
          in: query
          schema:
            type: string
        - description: OpenCost filter expression over cluster and node
          name: filter
          in: query
          schema:
            type: string
        - description: 'Comma-separated asset types to return: Node, Disk'
          name: filterTypes
          in: query
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/controllers.assetEnvelope'
        '400':
          description: Bad Request
          content:
            application/json:
              schema: {}
        '401':
          description: Unauthorized
          content:
            application/json:
              schema: {}
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema: {}
      security:
        - BearerAuth: []
components:
  schemas:
    controllers.assetEnvelope:
      type: object
      properties:
        code:
          type: integer
        data:
          type: array
          items:
            $ref: '#/components/schemas/opencost.AssetSet'
    opencost.AssetSet:
      type: object
      properties:
        aggregationKeys:
          type: array
          items:
            type: string
        any:
          description: '@bingen:field[ignore]'
          type: object
          additionalProperties:
            $ref: '#/components/schemas/opencost.Any'
        assets:
          type: object
          additionalProperties: {}
        cloud:
          description: '@bingen:field[ignore]'
          type: object
          additionalProperties:
            $ref: '#/components/schemas/opencost.Cloud'
        clusterManagement:
          description: '@bingen:field[ignore]'
          type: object
          additionalProperties:
            $ref: '#/components/schemas/opencost.ClusterManagement'
        disks:
          description: '@bingen:field[ignore]'
          type: object
          additionalProperties:
            $ref: '#/components/schemas/opencost.Disk'
        errors:
          type: array
          items:
            type: string
        fromSource:
          description: stores the name of the source used to compute the data
          type: string
        loadBalancers:
          description: '@bingen:field[ignore]'
          type: object
          additionalProperties:
            $ref: '#/components/schemas/opencost.LoadBalancer'
        network:
          description: '@bingen:field[ignore]'
          type: object
          additionalProperties:
            $ref: '#/components/schemas/opencost.Network'
        nodes:
          description: '@bingen:field[ignore]'
          type: object
          additionalProperties:
            $ref: '#/components/schemas/opencost.Node'
        sharedAssets:
          description: '@bingen:field[ignore]'
          type: object
          additionalProperties:
            $ref: '#/components/schemas/opencost.SharedAsset'
        warnings:
          type: array
          items:
            type: string
        window:
          $ref: '#/components/schemas/opencost.Window'
    opencost.Any:
      type: object
      properties:
        adjustment:
          type: number
          format: float64
        cost:
          type: number
          format: float64
        end:
          type: string
        labels:
          $ref: '#/components/schemas/opencost.AssetLabels'
        properties:
          $ref: '#/components/schemas/opencost.AssetProperties'
        start:
          type: string
        window:
          $ref: '#/components/schemas/opencost.Window'
    opencost.Cloud:
      type: object
      properties:
        adjustment:
          type: number
          format: float64
        cost:
          type: number
          format: float64
        credit:
          description: >-
            Credit is a negative value representing dollars credited back to a
            given line-item
          type: number
          format: float64
        end:
          type: string
        labels:
          $ref: '#/components/schemas/opencost.AssetLabels'
        properties:
          $ref: '#/components/schemas/opencost.AssetProperties'
        start:
          type: string
        window:
          $ref: '#/components/schemas/opencost.Window'
    opencost.ClusterManagement:
      type: object
      properties:
        adjustment:
          description: '@bingen:field[version=16]'
          type: number
          format: float64
        cost:
          type: number
          format: float64
        labels:
          $ref: '#/components/schemas/opencost.AssetLabels'
        properties:
          $ref: '#/components/schemas/opencost.AssetProperties'
        window:
          $ref: '#/components/schemas/opencost.Window'
    opencost.Disk:
      type: object
      properties:
        adjustment:
          type: number
          format: float64
        breakdown:
          $ref: '#/components/schemas/opencost.Breakdown'
        byteHours:
          type: number
          format: float64
        byteHoursUsed:
          description: '@bingen:field[version=18]'
          type: number
          format: float64
        byteUsageMax:
          description: '@bingen:field[version=18]'
          type: number
          format: float64
        claimName:
          description: '@bingen:field[version=18]'
          type: string
        claimNamespace:
          description: '@bingen:field[version=18]'
          type: string
        cost:
          type: number
          format: float64
        end:
          type: string
        labels:
          $ref: '#/components/schemas/opencost.AssetLabels'
        local:
          type: number
          format: float64
        properties:
          $ref: '#/components/schemas/opencost.AssetProperties'
        start:
          type: string
        storageClass:
          description: '@bingen:field[version=17]'
          type: string
        volumeName:
          description: '@bingen:field[version=18]'
          type: string
        window:
          $ref: '#/components/schemas/opencost.Window'
    opencost.LoadBalancer:
      type: object
      properties:
        adjustment:
          type: number
          format: float64
        cost:
          type: number
          format: float64
        end:
          type: string
        ip:
          description: '@bingen:field[version=21]'
          type: string
        labels:
          $ref: '#/components/schemas/opencost.AssetLabels'
        private:
          description: '@bingen:field[version=20]'
          type: boolean
        properties:
          $ref: '#/components/schemas/opencost.AssetProperties'
        start:
          type: string
        window:
          $ref: '#/components/schemas/opencost.Window'
    opencost.Network:
      type: object
      properties:
        adjustment:
          type: number
          format: float64
        cost:
          type: number
          format: float64
        end:
          type: string
        labels:
          $ref: '#/components/schemas/opencost.AssetLabels'
        properties:
          $ref: '#/components/schemas/opencost.AssetProperties'
        start:
          type: string
        window:
          $ref: '#/components/schemas/opencost.Window'
    opencost.Node:
      type: object
      properties:
        adjustment:
          type: number
          format: float64
        cpubreakdown:
          $ref: '#/components/schemas/opencost.Breakdown'
        cpucoreHours:
          type: number
          format: float64
        cpucost:
          type: number
          format: float64
        discount:
          type: number
          format: float64
        end:
          type: string
        gpucost:
          type: number
          format: float64
        gpucount:
          type: number
          format: float64
        gpuhours:
          type: number
          format: float64
        labels:
          $ref: '#/components/schemas/opencost.AssetLabels'
        nodeType:
          type: string
        overhead:
          description: '@bingen:field[version=19]'
          allOf:
            - $ref: '#/components/schemas/opencost.NodeOverhead'
        preemptible:
          type: number
          format: float64
        properties:
          $ref: '#/components/schemas/opencost.AssetProperties'
        rambreakdown:
          $ref: '#/components/schemas/opencost.Breakdown'
        rambyteHours:
          type: number
          format: float64
        ramcost:
          type: number
          format: float64
        start:
          type: string
        window:
          $ref: '#/components/schemas/opencost.Window'
    opencost.SharedAsset:
      type: object
      properties:
        cost:
          type: number
          format: float64
        labels:
          $ref: '#/components/schemas/opencost.AssetLabels'
        properties:
          $ref: '#/components/schemas/opencost.AssetProperties'
        window:
          $ref: '#/components/schemas/opencost.Window'
    opencost.Window:
      type: object
    opencost.AssetLabels:
      type: object
      additionalProperties:
        type: string
    opencost.AssetProperties:
      type: object
      properties:
        account:
          type: string
        category:
          type: string
        cluster:
          type: string
        name:
          type: string
        project:
          type: string
        provider:
          type: string
        providerID:
          type: string
        service:
          type: string
    opencost.Breakdown:
      type: object
      properties:
        idle:
          type: number
        other:
          type: number
        system:
          type: number
        user:
          type: number
    opencost.NodeOverhead:
      type: object
      properties:
        cpuOverheadFraction:
          type: number
          format: float64
        overheadCostFraction:
          type: number
          format: float64
        ramOverheadFraction:
          type: number
          format: float64
  securitySchemes:
    BearerAuth:
      description: Enter "Bearer {token}"
      type: apiKey
      name: Authorization
      in: header

````

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