Commitments

Commitments, such as savings plans, reservations, and committed use discounts, lower your rates in exchange for paying for a fixed amount whether you use it or not. CostGraph shows how much of your eligible usage they cover and how much of what you committed to goes unused. Read commitments with GET /api/v1/tenant/cost/commitments in the CostGraph API. It works with an API key that has the focus:read scope, and takes the same period and filters as cost queries.

curl "https://api.costgraph.ai/api/v1/tenant/cost/commitments?group_by=service&period=last_30d" \
  -H "X-API-Key: $COSTGRAPH_API_KEY" \
  -H "X-CostGraph-Tenant-ID: $TENANT_ID"

group_by is provider (the default), service, or commitment.

Measures

The response has totals and one entry per group, each split by billed currency:

Field	Meaning
`committedCost`	Usage paid for by a commitment
`onDemandCost`	Usage paid at on-demand rates
`unusedCommitmentCost`	Commitment you paid for but didn’t use
`unusedReservationCost`	Capacity reservations you paid for but didn’t use
`eligibleUsageCost`	Usage spend, the base for coverage
`coveragePct`	The share of eligible usage a commitment covered
`discountOffList`	What you saved against list price, when your provider reports list prices
`effectiveCost`	What you paid in total

Low coverage with steady usage suggests buying more commitment. High unusedCommitmentCost means you committed to more than you use. Graph AI and the MCP server read commitments too.

Get Started

CostGraph Operator

CostGraph Agent

GPUs

Insights

Alerts

Budgets & Forecast

Allocation

Virtual Tags

Network

MCP

Slack

Security

Developers

Self-Hosted

Integrations

Changelog

Measures

​Measures

Measures