/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. This endpoint is useful for visualizing commitment portfolio performance over time.

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

/commitments/chart

cURL

curl --request GET \
  --url https://api.archera.ai/v1/org/{org_id}/commitments/chart \
  --header 'x-api-key: <api-key>'

200

{
  "data": [
    {
      "date": "<string>",
      "remaining_commit": 123,
      "locked_commit": 123,
      "unlocked_commit": 123,
      "savings": 123,
      "net_savings": 123,
      "utilization": 123,
      "unutilized_commit": 123
    }
  ]
}

Authorizations

x-api-key · string · header · required

API key for authentication. Get your key from User Settings > API Access in the Archera platform.

Path Parameters

org_id · string · required

Minimum string length: 1

Query Parameters

filter · object

Optional JSON filter criteria for commitment data

Show child attributes

Example:

"{\"field\": \"type\", \"op\": \"=\", \"value\": \"Compute Instance\"}"

provider · enum<string> · required

Cloud provider to filter commitments by

Available options: aws, azure, gcp

Example:

"aws"

start_date · string<date> · required

Start date for the chart data (YYYY-MM-DD)

Example:

"2023-01-01"

end_date · string<date> · required

End date for the chart data (YYYY-MM-DD)

Example:

"2023-12-31"

Response

200

application/json

OK

data · object[]

Show child attributes