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

# List applications' cost projections

> Every application of the organisation with its cost projection in one call - the single application read's figures without the trend and the waste - and the fleet's run rate split into the namespaces applications run in (each once), the rest of the attributed clusters, and the clusters whose pass attributed no namespace. Bearer-PAT twin of the browser route of the same name under /org.



## OpenAPI

````yaml https://platform.ankra.app/openapi.json get /api/v1/org/cloud-cost/objects/application
openapi: 3.1.0
info:
  title: FastAPI
  version: 0.1.0
servers:
  - url: https://platform.ankra.app
security: []
tags:
  - name: Organisation IAM
    description: >-
      Custom organisation roles and scoped role assignments for member and
      service-account identities.
  - name: Clusters
    description: Create, inspect and manage clusters, and the stacks deployed on them.
  - name: Managed Clusters
    description: Provider-managed control planes, driven through one common surface.
  - name: Imported Clusters
    description: Clusters that already existed and were connected to Ankra.
  - name: Cluster Access
    description: Kubeconfigs, service-account tokens and per-cluster access grants.
  - name: Kubernetes
    description: Read and act on the Kubernetes objects inside a cluster.
  - name: AWS Clusters
    description: >-
      Provision and manage self-managed k3s / kubeadm clusters on AWS EC2 in
      your own VPC.
  - name: Ankra Cloud Clusters
    description: >-
      Provision and manage self-managed kubeadm / k3s clusters on Ankra Cloud
      servers: a private network, a NAT router and a bastion per cluster.
  - name: DigitalOcean Clusters
    description: Provision and manage DigitalOcean Kubernetes clusters.
  - name: Hetzner Clusters
    description: Provision and manage Hetzner Kubernetes clusters.
  - name: OVH Clusters
    description: Provision and manage OVH Kubernetes clusters.
  - name: Scaleway Clusters
    description: Provision and manage Scaleway Kapsule clusters.
  - name: UpCloud Clusters
    description: Provision and manage UpCloud Kubernetes clusters.
  - name: Applications
    description: Deploy, configure and observe applications across the fleet.
  - name: Pipelines
    description: >-
      Pipeline definitions, the approval of the authority they declare, and the
      caches pipelines keep between runs.
  - name: Deploy Targets
    description: >-
      Environments, the hosts registered to receive deployments, and the
      releases deployed to them.
  - name: Backups
    description: >-
      Backup vaults, restore points, protection posture and captures for stacks
      and application deployments; a completed capture is not a verified
      restore.
  - name: Stack Profiles
    description: Reusable stack definitions, their versions and sharing.
  - name: Services
    description: >-
      Versioned service packages and explicit sharing. Runtime admission is
      separate from publication.
  - name: Charts
    description: Browse the chart catalogue behind stacks and addons.
  - name: Helm
    description: Helm registries, credentials and the charts they expose.
  - name: Executions
    description: Long-running platform executions and their jobs.
  - name: Operations
    description: Cancel in-flight cluster operations and their jobs.
  - name: Chat
    description: Conversational sessions, plans and confirmable actions.
  - name: AI Management
    description: >-
      Customer agent lifecycle, authenticated identity and organisation
      automation controls.
  - name: AI Agent Runs
    description: Autonomous agent runs and their outcomes.
  - name: AI Tickets
    description: The AI ticket board, its sync connections and settings.
  - name: AI Playbooks
    description: Reusable playbooks the AI lanes execute.
  - name: AI Conditions
    description: Conditions that gate AI autonomy.
  - name: AI Remediation
    description: >-
      The organisation's auto-remediation policy: what the AI lanes may fix by
      themselves, and who approves the rest.
  - name: AI Engineering Handoffs
    description: Work the AI lanes escalate to a human engineer.
  - name: AI Environment
    description: The environment and base stacks AI demos deploy into.
  - name: Security
    description: Findings, advisories, SBOMs, compliance and posture.
  - name: Cost
    description: Cluster and fleet cost, rate cards and cost settings.
  - name: Decisions
    description: >-
      The decision ledger behind the Security and Cost queues: proposals a
      surface computed, the approve and set-aside decisions people took on them,
      and the receipts of running them.
  - name: Billing
    description: Subscription and spend caps.
  - name: Organisation
    description: Members, invitations, audit logs and organisation settings.
  - name: Account Tokens
    description: Personal access tokens for the API and CLI.
  - name: Credentials
    description: The shared credential store.
  - name: AWS Credentials
    description: >-
      AWS credentials: access keys or CloudFormation-onboarded STS roles for
      cost, EKS and self-managed provisioning.
  - name: Ankra Cloud Credentials
    description: >-
      Ankra Cloud API tokens, shared by the self-managed and managed Ankra Cloud
      lanes.
  - name: Azure Credentials
    description: Azure credentials and SSH keys.
  - name: DigitalOcean Credentials
    description: DigitalOcean credentials and SSH keys.
  - name: Hetzner Credentials
    description: Hetzner credentials and SSH keys.
  - name: OVH Credentials
    description: OVH credentials and SSH keys.
  - name: Scaleway Credentials
    description: Scaleway credentials.
  - name: UpCloud Credentials
    description: UpCloud credentials and SSH keys.
  - name: Data Source Credentials
    description: Credentials for metrics and log sources.
  - name: DNS Credentials
    description: Credentials for DNS providers.
  - name: Object Storage Buckets
    description: >-
      Buckets Ankra creates and manages on an organisation's own provider
      credentials.
  - name: DNS
    description: DNS zones and records, including custom organisation zones.
  - name: Cloudflare
    description: Cloudflare domains and the credentials behind them.
  - name: Avura
    description: >-
      The linked Avura organization, the domains it shares with Ankra Platform,
      and their DNS records.
  - name: Variables
    description: Organisation- and cluster-scoped variables.
  - name: SOPS
    description: Encrypt and decrypt values with the organisation SOPS config.
  - name: Alerts
    description: Alert integrations and ingest credentials.
  - name: Notifications
    description: Notification routes and their delivery targets.
  - name: Support
    description: Support tickets.
  - name: AI Settings
    description: Organisation AI provider, model catalog and per-function model settings
paths:
  /api/v1/org/cloud-cost/objects/application:
    get:
      tags:
        - Cost
      summary: List applications' cost projections
      description: >-
        Every application of the organisation with its cost projection in one
        call - the single application read's figures without the trend and the
        waste - and the fleet's run rate split into the namespaces applications
        run in (each once), the rest of the attributed clusters, and the
        clusters whose pass attributed no namespace. Bearer-PAT twin of the
        browser route of the same name under /org.
      operationId: object_cost_applications_api_v1_org_cloud_cost_objects_get
      parameters:
        - description: PAT organisation override.
          in: header
          name: x-ankra-organisation-id
          required: false
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApplicationCostList'
          description: Successful response
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContractDetailError'
          description: Missing or malformed Authorization header
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContractDetailError'
          description: Unknown, expired, or revoked API token
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContractDetailError'
          description: >-
            Token may not use this surface (MCP-scoped token or service account
            restriction)
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContractDetailError'
          description: Internal server error
      security:
        - BearerAuth: []
components:
  schemas:
    ApplicationCostList:
      description: >-
        Every application of the organisation with its cost projection, read in
        one call, and the fleet's run rate split against them so the
        applications' sum can be labelled honestly. A namespace two applications
        share is counted whole under each entry; the fleet block counts it once
        and names the shared part.
      properties:
        currency:
          description: >-
            The caller's display currency; every *_cents figure is in its minor
            units.
          type: string
        applications:
          items:
            $ref: '#/components/schemas/ApplicationCostEntry'
          type: array
        fleet:
          $ref: '#/components/schemas/ApplicationCostFleet'
        snapshot_stale_after_hours:
          description: The window a snapshot counts in.
          type: integer
      required:
        - currency
        - applications
        - fleet
        - snapshot_stale_after_hours
      title: ApplicationCostList
      type: object
    ContractDetailError:
      example:
        detail: Cluster not found
      properties:
        detail:
          oneOf:
            - type: string
            - additionalProperties: true
              properties: {}
              type: object
      required:
        - detail
      type: object
    ApplicationCostEntry:
      description: >-
        One application's projection: the figures of the single application
        read, field for field, without the trend and the open waste. Nothing
        unknown reads as zero.
      properties:
        application_id:
          type: string
          format: uuid
        name:
          type: string
        priced:
          description: >-
            At least one cluster behind the application contributed a figure.
            False leaves every figure null and names why in unpriced_reason.
          type: boolean
        unpriced_reason:
          anyOf:
            - type: string
            - type: 'null'
        monthly_cents:
          anyOf:
            - description: >-
                The run rate at the latest snapshot inside the window, times 730
                hours.
              type: integer
            - type: 'null'
        share_of_fleet_pct:
          anyOf:
            - description: >-
                monthly_cents over the fleet's run rate in the same window; null
                when either is unknown or the fleet is zero.
              type: number
            - type: 'null'
        confidence:
          anyOf:
            - description: >-
                The lowest confidence among the snapshots the figure is read
                from: high, medium or low.
              type: string
            - type: 'null'
        coverage_incomplete:
          anyOf:
            - description: >-
                The figure is a floor: a node or billed resource of a
                contributing cluster could not be priced, or a cluster behind
                the application contributed no figure (clusters names which).
              type: boolean
            - type: 'null'
        clusters:
          items:
            $ref: '#/components/schemas/ObjectCostCluster'
          type: array
        namespaces:
          items:
            $ref: '#/components/schemas/ObjectCostNamespace'
          type: array
      required:
        - application_id
        - name
        - priced
        - unpriced_reason
        - monthly_cents
        - share_of_fleet_pct
        - confidence
        - coverage_incomplete
        - clusters
        - namespaces
      title: ApplicationCostEntry
      type: object
    ApplicationCostFleet:
      description: >-
        The fleet's run rate (the fleet summary's figure) split into the
        namespaces applications run in (each counted once), the rest of the
        clusters whose latest pass attributed namespaces (idle capacity,
        unattributed storage, network, control plane, namespaces no application
        runs in), and the clusters whose pass attributed no namespace. The three
        add up to monthly_cents exactly.
      properties:
        priced:
          description: >-
            At least one cluster has a snapshot in the window; false leaves
            every figure null.
          type: boolean
        monthly_cents:
          anyOf:
            - description: The fleet's run rate.
              type: integer
            - type: 'null'
        applications_monthly_cents:
          anyOf:
            - description: >-
                What the namespaces applications run in cost, each once; null
                when no priced cluster's pass attributed namespaces.
              type: integer
            - type: 'null'
        shared_monthly_cents:
          anyOf:
            - description: >-
                The part of applications_monthly_cents in namespaces two or more
                applications share, counted under each of them in the entries.
              type: integer
            - type: 'null'
        outside_applications_monthly_cents:
          anyOf:
            - description: The rest of the attributed clusters' run rate.
              type: integer
            - type: 'null'
        unattributed_monthly_cents:
          anyOf:
            - description: >-
                The run rate of priced clusters whose latest pass attributed no
                namespace, which no split can be read for.
              type: integer
            - type: 'null'
        clusters:
          description: >-
            Every cluster behind the split: the priced ones and the
            organisation's live clusters with no snapshot in the window.
          items:
            $ref: '#/components/schemas/ApplicationCostFleetCluster'
          type: array
      required:
        - priced
        - monthly_cents
        - applications_monthly_cents
        - shared_monthly_cents
        - outside_applications_monthly_cents
        - unattributed_monthly_cents
        - clusters
      title: ApplicationCostFleet
      type: object
    ObjectCostCluster:
      description: >-
        One cluster behind the object. monthly_cents is this cluster's part of
        the object's figure, null when it contributed none; priced says it has a
        snapshot in the window at all; coverage_incomplete names a cluster whose
        own snapshot is a floor.
      properties:
        cluster_id:
          type: string
          format: uuid
        cluster_name:
          type: string
        priced:
          type: boolean
        monthly_cents:
          anyOf:
            - type: integer
            - type: 'null'
        confidence:
          anyOf:
            - type: string
            - type: 'null'
        coverage_incomplete:
          anyOf:
            - description: >-
                The cluster's own snapshot could not price a node or billed
                resource; null when the cluster is unpriced.
              type: boolean
            - type: 'null'
      required:
        - cluster_id
        - cluster_name
        - priced
        - monthly_cents
        - confidence
        - coverage_incomplete
      title: ObjectCostCluster
      type: object
    ObjectCostNamespace:
      description: >-
        One namespace behind a namespace-based object. shared says another
        application also runs in it, so its whole allocation is counted for
        each: the figure is the namespace's, not a split of it.
      properties:
        cluster_id:
          type: string
          format: uuid
        cluster_name:
          type: string
        namespace:
          type: string
        monthly_cents:
          anyOf:
            - type: integer
            - type: 'null'
        shared:
          type: boolean
      required:
        - cluster_id
        - cluster_name
        - namespace
        - monthly_cents
        - shared
      title: ObjectCostNamespace
      type: object
    ApplicationCostFleetCluster:
      description: >-
        One cluster's part of the fleet split. applications_monthly_cents and
        outside_applications_monthly_cents are null unless its latest pass
        attributed namespaces; monthly_cents is null when it has no snapshot in
        the window.
      properties:
        cluster_id:
          type: string
          format: uuid
        cluster_name:
          type: string
        priced:
          type: boolean
        monthly_cents:
          anyOf:
            - description: The cluster's run rate.
              type: integer
            - type: 'null'
        namespaces_attributed:
          type: boolean
        applications_monthly_cents:
          anyOf:
            - description: >-
                What the namespaces applications run in on this cluster cost,
                each once.
              type: integer
            - type: 'null'
        outside_applications_monthly_cents:
          anyOf:
            - description: The rest of this cluster's run rate.
              type: integer
            - type: 'null'
      required:
        - cluster_id
        - cluster_name
        - priced
        - monthly_cents
        - namespaces_attributed
        - applications_monthly_cents
        - outside_applications_monthly_cents
      title: ApplicationCostFleetCluster
      type: object
  securitySchemes:
    BearerAuth:
      bearerFormat: PAT
      scheme: bearer
      type: http

````

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