--- 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` ## Request - Base URL: `https://api.datadoghq.com` - URL: `https://api.datadoghq.com/api/v2/cost/commitments/commitment-list` - Auth: one of: - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY` - OAuth 2 - Authorization code: `/oauth2/v1/authorize` - Token URL: `/oauth2/v1/token` scopes: `cloud_cost_management_read` 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.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)