---
title: "Get commitments list"
method: GET
path: "/api/v2/cost/commitments/commitment-list"
tags: ["Cloud Cost Management"]
---

# Get commitments list

`GET /api/v2/cost/commitments/commitment-list`

Get a list of individual cloud commitments (Reserved Instances or Savings Plans) with their utilization details. The response schema varies based on the provider, product, and commitment type.

## Query parameters

- `provider` 'aws' | 'azure', required — Cloud provider for commitment programs.
- `product` string, required
- `start` integer, required
- `end` integer, required
- `filterBy` string
- `commitmentType` 'ri' | 'sp' — Type of commitment. ri for Reserved Instances, sp for Savings Plans.

## Response `200`

OK

- CommitmentsListResponse — Response containing a list of cloud commitment details.
  - `commitments` CommitmentsListItem[], required — Array of commitment items.
    - union — A commitment item, which varies based on the provider, product, and commitment type.
      - CommitmentsAwsEC2RICommitment — AWS EC2 Reserved Instance commitment details.
        - `availability_zone` string — The availability zone of the reservation.
        - `commitment_id` string, required — The unique identifier of the Reserved Instance.
        - `expiration_date` string — The expiration date of the commitment.
        - `instance_type` string, required — The EC2 instance type.
        - `number_of_nfus` number, double — The number of Normalized Capacity Units.
        - `number_of_reservations` number, double — The number of reserved instances.
        - `offering_class` string, required — The offering class of the Reserved Instance.
        - `operating_system` string, required — The operating system of the Reserved Instance.
        - `purchase_option` string, required — The payment option for the Reserved Instance.
        - `region` string, required — The AWS region of the Reserved Instance.
        - `start_date` string — The start date of the commitment.
        - `term_length` number, double — The term length in years.
        - `utilization` number, double — The utilization percentage of the commitment.
      - CommitmentsAwsRDSRICommitment — AWS RDS Reserved Instance commitment details.
        - `commitment_id` string, required — The unique identifier of the Reserved Instance.
        - `database_engine` string, required — The database engine of the Reserved Instance.
        - `expiration_date` string — The expiration date of the commitment.
        - `instance_type` string, required — The RDS instance type.
        - `is_multi_az` boolean — Whether the Reserved Instance is Multi-AZ.
        - `number_of_nfus` number, double — The number of Normalized Capacity Units.
        - `number_of_reservations` number, double — The number of reserved instances.
        - `purchase_option` string, required — The payment option for the Reserved Instance.
        - `region` string, required — The AWS region of the Reserved Instance.
        - `start_date` string — The start date of the commitment.
        - `term_length` number, double — The term length in years.
        - `utilization` number, double — The utilization percentage of the commitment.
      - CommitmentsAwsElasticacheRICommitment — AWS ElastiCache Reserved Instance commitment details.
        - `cache_engine` string, required — The cache engine type of the Reserved Instance.
        - `commitment_id` string, required — The unique identifier of the Reserved Instance.
        - `expiration_date` string — The expiration date of the commitment.
        - `instance_type` string, required — The ElastiCache instance type.
        - `number_of_nfus` number, double — The number of Normalized Capacity Units.
        - `number_of_reservations` number, double — The number of reserved instances.
        - `purchase_option` string, required — The payment option for the Reserved Instance.
        - `region` string, required — The AWS region of the Reserved Instance.
        - `start_date` string — The start date of the commitment.
        - `term_length` number, double — The term length in years.
        - `utilization` number, double — The utilization percentage of the commitment.
      - CommitmentsAwsSPCommitment — AWS Savings Plan commitment details.
        - `commitment_id` string, required — The unique identifier of the Savings Plan.
        - `committed_spend_per_hour` number, double — The hourly committed spend for the Savings Plan.
        - `expiration_date` string — The expiration date of the commitment.
        - `purchase_option` string, required — The payment option for the Savings Plan.
        - `savings_plan_type` string, required — The Savings Plan type.
        - `start_date` string — The start date of the commitment.
        - `term_length` number, double — The term length in years.
        - `utilization` number, double — The utilization percentage of the commitment.
      - CommitmentsAzureVMRICommitment — Azure Virtual Machine Reserved Instance commitment details.
        - `benefit_name` string, required — The display name of the Azure reservation.
        - `commitment_id` string, required — The unique identifier of the Reserved Instance.
        - `expiration_date` string — The expiration date of the commitment.
        - `instance_type` string, required — The Azure VM instance type.
        - `meter_sub_category` string, required — The Azure meter sub-category for the reservation.
        - `region` string, required — The Azure region of the Reserved Instance.
        - `start_date` string — The start date of the commitment.
        - `status` 'running' | 'expired' | 'cancelled', required — Status of an Azure VM Reserved Instance.
        - `term_length` number, double — The term length in years.
        - `utilization` number, double — The utilization percentage of the commitment.
      - CommitmentsAzureComputeSPCommitment — Azure Compute Savings Plan commitment details.
        - `benefit_name` string, required — The display name of the Azure Savings Plan.
        - `commitment_id` string, required — The unique identifier of the Savings Plan.
        - `committed_spend_per_hour` number, double — The hourly committed spend for the Savings Plan.
        - `expiration_date` string — The expiration date of the commitment.
        - `start_date` string — The start date of the commitment.
        - `term_length` number, double — The term length in years.
        - `utilization` number, double — The utilization percentage of the commitment.
  - `meta` CommitmentsListMeta — Metadata for a commitments list response.
    - `committed_spend_unit` CommitmentsUnit — Unit metadata for a numeric metric.
      - `family` string, required — The unit family (for example, percentage or money).
      - `id` integer, required — The unit identifier.
      - `name` string, required — The unit name (for example, percent or dollar).
      - `plural` string, required — The plural form of the unit name.
      - `scale_factor` number, double, required — The scale factor for the unit.
      - `short_name` string, required — The abbreviated unit name (for example, % or $).

## Other responses

- `400` — Bad Request
- `429` — Too many requests

---

[API](https://skmtc.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/revisions/da68bf029e4c/schema)