---
title: "Api Reserve Commitment"
method: POST
path: "/api/pricing/reserve"
tags: ["Billing"]
---

# Api Reserve Commitment

`POST /api/pricing/reserve`

Create a reserved pricing commitment for a customer.

Reserved instances are 20-45% cheaper than on-demand, depending on
commitment length. The customer pre-commits to a term and receives
a guaranteed discount on all GPU hours consumed during that period.

## Request body

- ReservedCommitmentRequest
  - `customer_id` string, required
  - `gpu_model` string
  - `commitment_type` string
  - `quantity` integer
  - `province` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2026-04-05** `f2668775365c` — 1 info
  - endpoint added
- **2026-04-03** `aca6ce6b2785` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/aabiro/apis/xcelsior/changes/api/pricing/reserve/post.md)

---

[API](https://skmtc.dev/aabiro/apis/xcelsior.md) · [All operations](https://skmtc.dev/aabiro/apis/xcelsior/llms.txt) · [OpenAPI document](https://skmtc.dev/aabiro/apis/xcelsior/revisions/95960849edcd?raw)