---
title: "List Cost Reservations & Utilization"
method: GET
path: "/cost/ri/utilization/reservations"
tags: ["Cost"]
---

# List Cost Reservations & Utilization

`GET /cost/ri/utilization/reservations`

list reservation utilization

## Query parameters

- `date_filter` 'current_month' | 'current_month_minus_1' | 'current_month_minus_2' | 'current_month_minus_3' | 'current_month_minus_4' | 'current_month_minus_5' | 'current_month_minus_6' | 'current_month_minus_7' | 'current_month_minus_8' | 'current_month_minus_9' | 'current_month_minus_10' | 'current_month_minus_11' | 'current_month_minus_12', required
- `currency` 'AED' | 'ALL' | 'ARS' | 'AUD' | 'BAM' | 'BDT' | 'BGN' | 'BHD' | 'BRL' | 'CAD' | 'CHF' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CZK' | 'DKK' | 'EGP' | 'EUR' | 'GBP' | 'HKD' | 'HRK' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'ISK' | 'JPY' | 'KES' | 'KRW' | 'KWD' | 'KZT' | 'MOP' | 'MVR' | 'MXN' | 'MYR' | 'NOK' | 'NZD' | 'OMR' | 'PEN' | 'PHP' | 'PKR' | 'PLN' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'SAR' | 'SEK' | 'SGD' | 'THB' | 'TRY' | 'TWD' | 'USD' | 'VND' | 'ZAR', required
- `service` 'AWS' | 'Azure' | 'AzureStack' | 'Azure_CSP' | 'Azure_CSP-Direct' | 'Azure_EA' | 'Azure_MCA' | 'Cloudstack' | 'GCP' | 'MS_VMM' | 'OCI' | 'Openstack' | 'PrivateCloud' | 'Rackspace' | 'VMware' | 'VMware_VCD' | 'vCenter'

## Response `200`

Success

- ListReservationsResponse
  - `filters` FilterValue, required
    - `reservation_sku` string[], required — Reservation SKU Details
    - `payment_option` string[], required — Available payment option
    - `region` string[], required — Region available
    - `reservation_type` string[], required — Reservation Type
    - `cloud_account` RangeValue[], required — Cloud Account Details
      - `range` FromToValue
        - `from` integer — Starting value of the range.Example 'from': 1000
        - `to` integer — Ending value of the range.Example 'to': 100000
    - `tenant` string[], required — Tenant name
  - `net_savings` integer, required — Net savings value
  - `expiring_in_thirty_days` integer, required — How many days are left out for expiry in that month
  - `on_demand_cost` integer, required — On Demand Cost Value
  - `reservations` ReservationDetails[], required — Reservation
    - `tenant_name` string, required — Tenant Name
    - `tenant_id` string — Tenant ID
    - `reservation_id` string, required — Reservation Id
    - `payment_option` string, required — What is the payment option
    - `ri_hours_used` string, required — RI hours being used
    - `expiry_date` string, required — Date of expiry
    - `reservation_sku` string, required — Reservation SKU Details
    - `region` string, required — Region
    - `cloud_account_name` string, required — Cloud Account Name
    - `cloud_account_id` string, required — Cloud Account Id
    - `utilization_percentage` string, required — Utilization by percentage
  - `page_count` integer, required — Page Count
  - `reservation_cost` integer, required — Reservation Cost Value
  - `total_count` integer, required — Total Count
  - `potential_cost_savings_recommended` number, required — Cost saved based on recommendation

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.dev/corestack/apis/corestack-external-api.md) · [All operations](https://skmtc.dev/corestack/apis/corestack-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/corestack/corestack-external-api/revisions/bf2cdf20826d/schema)