---
title: "Price of a cluster for the running month"
method: GET
path: "/api/clusters/{clusterName}/price"
tags: ["Cluster"]
---

# Price of a cluster for the running month

`GET /api/clusters/{clusterName}/price`

## Request

- The document declares no server URL.
- Auth: none declared. Required headers: `Authorization`

The cluster's month statement: partner, sponsors and, per unit family (DBU, failover DBU, APU, BKU, BAU), plan, over-commit and under-commit in unit-months, unit price, EUR accrued, rate and projection. Integrated per monitoring period by the resource manager.

## Path parameters

- `clusterName` string, required

## Headers

- `Authorization` string, required

## Response `200`

OK

- ClusterClusterStatement
  - `accrued` object: Accrued unit-seconds per family, kept on disk so a reload continues the month: plan, over, under, rate, planCost, overCost, underCredit.
  - `cluster` string
  - `firstSeen` string
  - `lastSeen` string
  - `monthCost` number: EUR accrued this month
  - `partner` string
  - `projected` number: MonthCost + Rate × the time left
  - `rate` number: EUR per month at the last tick
  - `sponsors` string[]
  - `units` ClusterUnitBillingRow[]
    - `billable` number
    - `cumulative` boolean: month-to-date volume, not integrated (#1872)
    - `family` string
    - `freePlan` boolean: the plan is a free allowance: no plan cost, no unused credit
    - `monthCost` number: = monthPlanCost + monthOverCost − monthUnderCredit
    - `monthOverCommit` number
    - `monthOverCost` number
    - `monthPlan` number
    - `monthPlanCost` number
    - `monthUnderCommit` number
    - `monthUnderCredit` number
    - `overCommit` number
    - `overCommitPct` integer
    - `overCost` number: + over-commit × price × (100+over%)/100
    - `plan` number
    - `planCost` number: plan × price, per month, at the last tick
    - `priced` boolean
    - `projectedCost` number
    - `projectedOverCommit` number
    - `projectedOverCost` number
    - `projectedPlan` number: Projection to the end of the month: each component as it stands at the last tick carried over the time left (plan count of every tick, over-commit and under-commit projected per unit), then priced: projectedCost = monthCost + rate × time left.
    - `projectedPlanCost` number
    - `projectedUnderCommit` number
    - `projectedUnderCredit` number
    - `rate` number: EUR per month at the last tick = planCost + overCost − underCredit
    - `underCommit` number
    - `underCommitPct` integer
    - `underCredit` number: − under-commit × price × under%/100
    - `unit` string
    - `unitPrice` number

## Other responses

- `403`: No valid ACL
- `404`: No statement yet

## Changes

- **2026-10-05** `0881418a9a9c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/signal18/apis/signal-18-dashboard-api/changes/api/clusters/:clusterName/price/get.md)

---

[API](https://skmtc.dev/signal18/apis/signal-18-dashboard-api.md) - [All operations](https://skmtc.dev/signal18/apis/signal-18-dashboard-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signal18/apis/signal-18-dashboard-api/revisions/8ee8a1e31294?raw)