> 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/coverage-detail.md).

# Coverage Detail

## Get detailed coverage breakdown by specified grouping

> Fetches detailed coverage breakdown for specific dimensions like Instance Family, Region, etc. within the specified date range.

```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}/v2/coverage/detail":{"post":{"tags":["Coverage Detail"],"summary":"Get detailed coverage breakdown by specified grouping","description":"Fetches detailed coverage breakdown for specific dimensions like Instance Family, Region, etc. within the specified date range.","operationId":"CoverageDetail","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":"start_date","in":"query","required":true,"schema":{"type":"string","format":"date"},"description":"Start date for the coverage calculation period."},{"name":"end_date","in":"query","required":true,"schema":{"type":"string","format":"date"},"description":"End date for the coverage calculation period."},{"name":"accountIdentifier","in":"query","required":true,"schema":{"type":"string"},"description":"Identifier of the account."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"group_by":{"type":"string","enum":["Instance Family","Region","Machine Type"],"description":"Dimension to group coverage data by"},"service":{"type":"string","enum":["Amazon Relational Database Service","Amazon Elastic Compute Cloud - Compute","VirtualMachines"],"default":"Amazon Elastic Compute Cloud - Compute","description":"Service to fetch the details for."}},"required":["group_by"]}}}},"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ComputeCoveragesDetailResponse"}}}},"400":{"description":"Invalid request parameters"}}}}},"components":{"schemas":{"ComputeCoveragesDetailResponse":{"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/ComputeCoveragesDetail"}}}},"ComputeCoveragesDetail":{"type":"object","properties":{"table":{"$ref":"#/components/schemas/ComputeCoveragesDetailTable"},"chart":{"type":"array","items":{"$ref":"#/components/schemas/ComputeCoverageChart"}}}},"ComputeCoveragesDetailTable":{"type":"object","properties":{"reservation_cost":{"type":"number","format":"double","nullable":true,"description":"Total cost for reserved instances"},"total_cost":{"type":"number","format":"double","nullable":true,"description":"Total cost including all coverage types"},"on_demand_cost":{"type":"number","format":"double","nullable":true,"description":"Cost for on-demand instances"},"total_hours":{"type":"number","format":"double","nullable":true,"description":"Total hours of usage"},"total_covered_hours":{"type":"number","format":"double","nullable":true,"description":"Total hours covered by RI or SP"},"on_demand_hours":{"type":"number","format":"double","nullable":true,"description":"Hours billed at on-demand rates"},"savings_plan_hours":{"type":"number","format":"double","nullable":true,"description":"Hours covered by savings plans"},"ri_coverage_hours":{"type":"number","format":"double","nullable":true,"description":"Hours covered by reserved instances"},"coverage":{"type":"number","format":"float","nullable":true,"description":"Coverage percentage"},"region":{"type":"string","nullable":true,"description":"Region information when grouped by region"},"machine_type":{"type":"string","nullable":true,"description":"Machine type information when grouped by machine type"},"trend":{"type":"number","format":"float","nullable":true,"description":"Trend in coverage percentage compared to previous period"},"spot_cost":{"type":"number","format":"double","nullable":true,"description":"Cost for spot instances"},"spot_hours":{"type":"number","format":"double","nullable":true,"description":"Hours covered by spot instances"}}},"ComputeCoverageChart":{"type":"object","properties":{"date":{"type":"string","format":"date-time","description":"Date for the chart data point"},"coverage_cost":{"type":"number","format":"double","description":"Coverage cost for the date"}}}}}}
```
