> 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-details.md).

# Coverage Details

## Get Savings Plans coverage details

> Returns SP coverage detail rows grouped by (service, instance\_family, region). Each row contains SP-covered spend, on-demand spend and coverage percentage for the given 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/details/savingsplans":{"post":{"tags":["Coverage Details"],"summary":"Get Savings Plans coverage details","description":"Returns SP coverage detail rows grouped by (service, instance_family, region). Each row contains SP-covered spend, on-demand spend and coverage percentage for the given date range.","operationId":"SPCoverageDetails","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":"Identifier of the account."},{"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."}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CopmputeCoverageFilter"}}}},"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SPCoverageDetailsResponse"}}}},"400":{"description":"Invalid request parameters"},"500":{"description":"Internal server error"}}}}},"components":{"schemas":{"CopmputeCoverageFilter":{"type":"object","properties":{"regions":{"type":"array","items":{"type":"string"}},"instance_types":{"type":"array","items":{"type":"string"}},"cloud_account_ids":{"type":"array","items":{"type":"string"}},"service":{"type":"string","enum":["Amazon Elastic Compute Cloud - Compute","Amazon Relational Database Service","VirtualMachines"]},"sort_by":{"type":"string","description":"Field to sort by. SP: sp_covered_spend, on_demand_spend, coverage_percentage. RI: average_coverage, reservation_covered_hrs, on_demand_hrs, total_running_hrs, on_demand_cost."},"sort_order":{"type":"string","enum":["asc","desc"],"description":"Sort direction. Defaults to desc if not specified."}}},"SPCoverageDetailsResponse":{"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","nullable":true,"description":"Error message, if any"},"response":{"type":"array","items":{"$ref":"#/components/schemas/SPCoverageDetailRow"},"description":"List of SP coverage detail rows grouped by service, instance family and region"}}},"SPCoverageDetailRow":{"type":"object","properties":{"service":{"type":"string","description":"AWS service name (e.g. Amazon Elastic Compute Cloud - Compute)"},"instance_family":{"type":"string","description":"Instance family (e.g. t3, m5)"},"region":{"type":"string","description":"AWS region"},"sp_covered_spend":{"type":"number","format":"double","description":"Spend covered by savings plans"},"on_demand_spend":{"type":"number","format":"double","description":"On-demand spend not covered by savings plans"},"coverage_percentage":{"type":"number","format":"double","description":"Percentage of total spend covered by savings plans (0-100)"}}}}}}
```

## Get Reserved Instances coverage details

> Returns RI coverage detail rows grouped by (instance\_type, platform, tenancy, region). Each row contains reservation covered hours, on-demand hours, total running hours, on-demand cost and average coverage percentage for the given 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/details/reservedinstances":{"post":{"tags":["Coverage Details"],"summary":"Get Reserved Instances coverage details","description":"Returns RI coverage detail rows grouped by (instance_type, platform, tenancy, region). Each row contains reservation covered hours, on-demand hours, total running hours, on-demand cost and average coverage percentage for the given date range.","operationId":"RICoverageDetails","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":"Identifier of the account."},{"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."}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CopmputeCoverageFilter"}}}},"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RICoverageDetailsResponse"}}}},"400":{"description":"Invalid request parameters"},"500":{"description":"Internal server error"}}}}},"components":{"schemas":{"CopmputeCoverageFilter":{"type":"object","properties":{"regions":{"type":"array","items":{"type":"string"}},"instance_types":{"type":"array","items":{"type":"string"}},"cloud_account_ids":{"type":"array","items":{"type":"string"}},"service":{"type":"string","enum":["Amazon Elastic Compute Cloud - Compute","Amazon Relational Database Service","VirtualMachines"]},"sort_by":{"type":"string","description":"Field to sort by. SP: sp_covered_spend, on_demand_spend, coverage_percentage. RI: average_coverage, reservation_covered_hrs, on_demand_hrs, total_running_hrs, on_demand_cost."},"sort_order":{"type":"string","enum":["asc","desc"],"description":"Sort direction. Defaults to desc if not specified."}}},"RICoverageDetailsResponse":{"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","nullable":true,"description":"Error message, if any"},"response":{"type":"array","items":{"$ref":"#/components/schemas/RICoverageDetailRow"},"description":"List of RI coverage detail rows grouped by instance type, platform, tenancy and region"}}},"RICoverageDetailRow":{"type":"object","properties":{"instance_type":{"type":"string","description":"EC2 instance type (e.g. m5.2xlarge, t3.medium)"},"platform":{"type":"string","description":"Operating system platform"},"tenancy":{"type":"string","description":"Instance tenancy (Shared, Dedicated, Host)"},"region":{"type":"string","description":"AWS region"},"average_coverage":{"type":"number","format":"double","description":"Average RI coverage percentage (0-100)"},"reservation_covered_hrs":{"type":"number","format":"double","description":"Hours covered by reserved instances"},"on_demand_hrs":{"type":"number","format":"double","description":"Hours billed at on-demand rates"},"total_running_hrs":{"type":"number","format":"double","description":"Total running hours (reservation covered + on-demand)"},"on_demand_cost":{"type":"number","format":"double","description":"Cost for on-demand hours"}}}}}}
```
