v1

latestOpenAPI 3.1.02026-08-042955230.1 KB
Exchanges

Get Azure exchange recommendations

Returns Azure reservation exchange recommendations using the same recommendation logic as the beta exchange endpoint, including plan-derived exchanges and eligible same-SKU 1-year native to 1-year GRI exchanges. When plan_id is omitted, the endpoint prefers the latest calculated 'Recommended RIs Only' default plan for the provider-resources segment (a twin of the Recommended plan without savings plans, which cannot be exchanged), falling back to the Recommended default plan when that plan does not exist yet. Currently only provider=azure is supported.

get/v1/org/{org_id}/exchanges/recommendations

Query parameters

provider'aws' | 'azure' | 'gcp' required
Example:aws

Cloud provider (aws, azure, gcp)

plan_idstring uuid nullable

Optional commitment plan ID to use for plan-derived exchange purchases. When omitted, the endpoint prefers the latest calculated 'Recommended RIs Only' default plan for the provider-resources segment — a twin of the Recommended plan without savings plans, which cannot be exchanged — falling back to the same Recommended default plan selected by GET /commitment-plans/recommended when that plan does not exist yet. Responses may also include non-plan-derived native-to-GRI exchanges.

commitment_idsstring[] nullable

Optional explicit Azure commitment IDs to consider returning. When omitted, the exchanger detects underutilized exchange candidates from the default 3-day DailyUtilization lookback. Explicit commitments without utilization rows in that lookback are excluded. Mutually exclusive with plan_id.

Response

OK

current_utilization_lookback_daysinteger required

Number of trailing days of DailyUtilization used for returned-commitment utilization and financials.