---
title: "/commitments/chart"
method: GET
path: "/v1/org/{org_id}/commitments/chart"
tags: ["Commitments"]
---

# /commitments/chart

`GET /v1/org/{org_id}/commitments/chart`

Generates time-series chart data for commitment metrics over the specified time period. The data includes daily or monthly values for commitment spend, utilization, locked vs unlocked commitments, and realized savings. Results are aggregated by day or month depending on the date range selected. 

**Future Projections:** When the end_date extends into the future, the API returns projected values based on current commitment utilization patterns. Each data point includes an `is_projection` field that indicates whether the values are historical (false) or projected (true). Projected values assume that active commitments will continue with their current utilization rates through their expiration dates. This is useful for forecasting future commitment costs and savings based on existing commitments.

## Query parameters

- `filter` object, nullable
- `provider` 'aws' | 'azure' | 'gcp', required
- `start_date` string, date, required
- `end_date` string, date, required

## Response `200`

OK

- PubChartResponse
  - `data` DataPoint[]
    - `date` string, required
    - `remaining_commit` number, required
    - `locked_commit` number, required
    - `unlocked_commit` number, required
    - `savings` number, required
    - `net_savings` number, required
    - `utilization` number, required
    - `unutilized_commit` number, required
    - `is_projection` boolean, required — Indicates whether this data point is a projection based on current commitment utilization patterns. Historical data (is_projection=false) reflects actual recorded metrics, while projected data (is_projection=true) represents estimated future values assuming commitments continue with their current utilization rates.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `405` — Method not allowed
- `409` — Conflict
- `422` — Unprocessable Content
- `500` — Internal server error
- `default` — Default error response

---

[API](https://skmtc.dev/archera/apis/archera-ai-api.md) · [All operations](https://skmtc.dev/archera/apis/archera-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/archera/archera-ai-api/revisions/3a24a8454a72/schema)