> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/api-reference/cost-management-agent-apis/commitment-orchestrator/commitment-utilization.md).

# Commitment Utilization

## Get commitment utilization details

> Retrieves detailed utilization data for savings plans and reserved instances with charts and trends

```json
{"openapi":"3.0.1","info":{"title":"Commitment Orchestrator APIs","version":"1.0.0"},"tags":[],"servers":[{"url":"https://app.harness.io/gateway","description":"Production server"}],"paths":{"/accounts/{account_id}/v1/detail/commitment_utilisation":{"get":{"tags":["Commitment Utilization"],"summary":"Get commitment utilization details","description":"Retrieves detailed utilization data for savings plans and reserved instances with charts and trends","operationId":"GetCommitmentUtilizationDetails","parameters":[{"name":"account_id","in":"path","required":true,"schema":{"type":"string"},"description":"Account Identifier for the entity"},{"name":"routingId","in":"query","required":true,"schema":{"type":"string"},"description":"Routing identifier for request processing"},{"name":"accountIdentifier","in":"query","required":true,"schema":{"type":"string"},"description":"Account identifier"},{"name":"start_date","in":"query","required":true,"schema":{"type":"string","format":"date"},"description":"Start date for the utilization data period"},{"name":"end_date","in":"query","required":true,"schema":{"type":"string","format":"date"},"description":"End date for the utilization data period"},{"name":"regions","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"}},"description":"Filter by regions (Note: Regional filtering has limitations for savings plans)","style":"form","explode":true},{"name":"cloud_account_ids","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"}},"description":"Filter by cloud account IDs","style":"form","explode":true},{"name":"service","in":"query","required":false,"schema":{"type":"string","enum":["Amazon Elastic Compute Cloud - Compute","Amazon Relational Database Service"]},"description":"Filter by AWS service"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommitmentUtilizationDetailResponse"}}}},"400":{"description":"Invalid request parameters"}}}}},"components":{"schemas":{"CommitmentUtilizationDetailResponse":{"type":"object","properties":{"ts":{"type":"integer","format":"int64","description":"Timestamp of the response"},"success":{"type":"boolean","description":"Indicates whether the request was successful"},"errors":{"type":"string","description":"Error message, if any"},"response":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/CommitmentUtlizationsDetail"},"description":"Response object containing savings plans and reserved instances utilization details"}}},"CommitmentUtlizationsDetail":{"type":"object","properties":{"table":{"$ref":"#/components/schemas/CommitmentUtilizationsDetailTable"},"chart":{"type":"array","items":{"$ref":"#/components/schemas/CommitmentUtilizationChart"}}}},"CommitmentUtilizationsDetailTable":{"type":"object","properties":{"compute_spend":{"type":"number","format":"double","description":"Total compute spend amount"},"utilization":{"type":"number","format":"double","description":"Utilization amount"},"percentage":{"type":"number","format":"double","description":"Utilization percentage"},"trend":{"type":"number","format":"double","nullable":true,"description":"Trend in utilization percentage compared to previous period"}}},"CommitmentUtilizationChart":{"type":"object","properties":{"date":{"type":"string","format":"date-time","description":"Date for the utilization data point"},"utilization_percentage":{"type":"number","format":"double","description":"Utilization percentage for the date"}}}}}}
```
