---
title: "Get RI Coverage"
method: GET
path: "/api/v2/commitments/riCoverage"
tags: ["Reserved Instances (RI)"]
---

# Get RI Coverage

`GET /api/v2/commitments/riCoverage`

## Request

- Base URL: `https://api.umbrellacost.io`
- URL: `https://api.umbrellacost.io/api/v2/commitments/riCoverage`
- Auth: none declared

Get Reserved Instance coverage metrics showing what percentage of eligible instance hours are covered by RIs

## Query parameters

- `start` string, required
- `end` string, required
- `granularity` string, required
- `linkedAccIds` string[]
- `regions` string[]
- `services` string[]
- `costCenters` string[]
- `customers` string[]
- `enrichmentTags` string[]
- `instanceTypes` string[]
- `reservationIds` string[]
- `subscriptions` string[]

## Headers

- `Authorization` string
- `apikey` string

## Response `200`

OK

- object

---

[API](https://skmtc.dev/umbrellacost/apis/commitments-public-api.md) - [All operations](https://skmtc.dev/umbrellacost/apis/commitments-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/umbrellacost/apis/commitments-public-api/revisions/201654153ec8?raw)