> ## 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. # Get a stack's cost projection (bearer twin) > What one stack of a cluster costs: the allocations of the namespaces its cluster's latest metering pass attributes to it (a namespace two stacks claim is attributed to neither), its share of the fleet and 30 days of daily cost. 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/stack/{cluster_id}/{stack_name} openapi: 3.1.0 info: title: FastAPI version: 0.1.0 servers: - url: https://platform.ankra.app security: [] tags: - 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: 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: 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 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: 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: 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/stack/{cluster_id}/{stack_name}: get: tags: - Cost summary: Get a stack's cost projection (bearer twin) description: >- What one stack of a cluster costs: the allocations of the namespaces its cluster's latest metering pass attributes to it (a namespace two stacks claim is attributed to neither), its share of the fleet and 30 days of daily cost. Bearer-PAT twin of the browser route of the same name under /org. operationId: object_cost_stack_api_v1_org_cloud_cost_objects_get parameters: - description: PAT organisation override. in: header name: x-ankra-organisation-id required: false schema: type: string - name: cluster_id in: path required: true schema: type: string format: uuid - description: The stack's name on the cluster. in: path name: stack_name required: true schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/ObjectCostProjection' 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) '404': content: application/json: schema: $ref: '#/components/schemas/ContractDetailError' description: >- Cluster not found in the token's organisation, or no stack of that name on it (Object not found) '422': content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' description: Request validation error '500': content: application/json: schema: $ref: '#/components/schemas/ContractDetailError' description: Internal server error security: - BearerAuth: [] components: schemas: ObjectCostProjection: description: >- What one object of the organisation costs now and over the last 30 days, read from the same snapshots and staleness window as the fleet summary. A cluster-based object (a cluster, a credential) costs its clusters' run rate, idle capacity included; a namespace-based object (a namespace, a stack, an application) costs its namespaces' allocations and has no idle share. Nothing unknown reads as zero. properties: kind: enum: - cluster - namespace - stack - application - credential type: string object: $ref: '#/components/schemas/ObjectCostSubject' currency: description: >- The caller's display currency; every *_cents figure is in its minor units. type: string priced: description: >- At least one cluster behind the object 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' idle_pct: anyOf: - description: >- The share of the run rate idle capacity accounts for; cluster-based objects only. type: number - 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 object contributed no figure (clusters names which). type: boolean - type: 'null' open_waste: $ref: '#/components/schemas/ObjectCostWaste' trend_30d: description: The object's cost per UTC day over the last 30 days, oldest first. items: $ref: '#/components/schemas/ObjectCostDay' type: array clusters: items: $ref: '#/components/schemas/ObjectCostCluster' type: array namespaces: description: >- The namespaces behind a namespace-based object; empty for a cluster-based one. items: $ref: '#/components/schemas/ObjectCostNamespace' type: array snapshot_stale_after_hours: description: The window a snapshot counts in. type: integer required: - kind - object - currency - priced - unpriced_reason - monthly_cents - idle_pct - share_of_fleet_pct - confidence - coverage_incomplete - open_waste - trend_30d - clusters - namespaces - snapshot_stale_after_hours title: ObjectCostProjection type: object ContractDetailError: example: detail: Cluster not found properties: detail: oneOf: - type: string - additionalProperties: true properties: {} type: object required: - detail type: object HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' title: Detail type: array title: HTTPValidationError type: object ObjectCostSubject: properties: id: description: The object's id; the namespace name for a namespace. type: string name: type: string cluster_id: anyOf: - type: string format: uuid - type: 'null' cluster_name: anyOf: - type: string - type: 'null' required: - id - name - cluster_id - cluster_name title: ObjectCostSubject type: object ObjectCostWaste: description: >- The open cloud waste attributed to the object. Waste is found per cloud resource, so only a cluster or a credential carries it; available false names why it is not read, which is unknown, not none. properties: available: type: boolean reason: anyOf: - type: string - type: 'null' count: type: integer monthly_cents: anyOf: - description: >- The priced findings' monthly cost; unpriced_count findings have no price and are not in it. type: integer - type: 'null' unpriced_count: type: integer required: - available - reason - count - monthly_cents - unpriced_count title: ObjectCostWaste type: object ObjectCostDay: description: >- One UTC day: the object's cost over the hours the metering covered (an hour costs the mean of its passes). cents is null when none of the object's clusters was metered that day. properties: date: format: date type: string cents: anyOf: - type: integer - type: 'null' clusters_metered: type: integer clusters_total: type: integer required: - date - cents - clusters_metered - clusters_total title: ObjectCostDay 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 ValidationError: properties: loc: items: anyOf: - type: string - type: integer title: Location type: array msg: title: Message type: string type: title: Error Type type: string required: - loc - msg - type title: ValidationError type: object securitySchemes: BearerAuth: bearerFormat: PAT scheme: bearer type: http ````