Docs
Reservations

Find GPU reservation offerings

GET
/v1/reservation-offerings

Returns up to six priced offerings for whole GPUs of one model, for a term of at least seven days, starting as near to start as capacity allows. Each offering's price holds until its expiresAt. An empty list means nothing fits.

Authorization

headerAuthorizationBearer <cc_...>

An API key of your org, sent as Authorization: Bearer cc_.... Keys start with cc_ and are otherwise opaque. Treat a key as a password: anyone holding it can act with its scopes until it expires or is revoked. Each operation's security requirement lists the scopes it needs; an empty list means any valid key. The MCP server at /mcp accepts agent keys and no other kind.

Scope: reservations:read

Query Parameters

location?array<>

Only these locations.

Itemsitems <= 16
tee?array<>

Only these TEEs.

Itemsitems <= 8
gpuModel*string

The GPU model to reserve.

Match^[a-z0-9]([-a-z0-9]*[a-z0-9])?$
Length1 <= length <= 32
gpuCount*integer

How many GPUs to reserve: the GPU count of one of the model's sizes in GET /v1/sizes (1, 2, 4 or 8 for b300), or a multiple of the largest. Any other count returns 400 invalid_request.

Range1 <= value <= 512
start?string

The start you want, as an RFC 3339 time in UTC. Offerings start at 00:00 UTC on the days nearest to it that have room, before or after it but never in the past. Without it, as soon as possible. A start further ahead than we take reservations returns no offerings, not an error.

Formatdate-time
term*string

The length of the reservation, as an ISO 8601 count of days. At least P7D and at most P365D.

Match^P([7-9]|[1-9][0-9]|[12][0-9]{2}|3[0-5][0-9]|36[0-5])D$

Header Parameters

Api-Version*string

The API version the request is written against. This document describes 2026-10-15. A missing header returns 400 api_version_required, and a version the API does not serve returns 400 unsupported_api_version.

X-Correlation-ID?string

An id of your own for this request, or for a group of requests, to find them in our logs and yours. Logged with the request and returned unchanged in X-Correlation-ID. The request id itself is always the API's own, in X-Request-ID.

Match^[A-Za-z0-9._:-]+$
Length1 <= length <= 128
Org-Context?string

Admin keys only: the id of the org to act in. Required with an admin key, together with Access-Reason; with any other credential it returns 400 invalid_request. Every request that carries it is recorded in that org's operator-access log.

Match^org-[a-z0-9]([-a-z0-9]*[a-z0-9])?$
Length5 <= length <= 63
Access-Reason?string

Admin keys only: why the operator is acting in the org, such as a support ticket. Required with Org-Context. Recorded, verbatim, in the org's operator-access log.

Match^[^\x00-\x1F\x7F]+$
Length10 <= length <= 500

Response Body

Up to six offerings, closest to the requested start first. Empty when nothing fits.

application/json
  1. response

At most six offerings. Not paged.

items*array<>
Example Request
curl -X GET 'https://api.cloud.confidential.ai/v1/reservation-offerings?location=us-west-1&tee=tdx&gpuModel=b300&gpuCount=8&start=2026-11-02T00%3A00%3A00Z&term=P30D' \  -H 'Api-Version: 2026-10-15' \  -H 'X-Correlation-ID: rollout-2026-10-22' \  -H 'Access-Reason: Support ticket 4821: customer asked why i-6d3f9h2k8mzr failed'
Example Response
{  "items": [    {      "id": "ro-3hx8k2",      "location": "us-west-1",      "tee": "tdx",      "gpu": {        "model": "b300",        "count": 8      },      "start": "2026-11-02T00:00:00Z",      "end": "2026-12-02T00:00:00Z",      "term": "P30D",      "price": {        "currency": "USD",        "perGpuHour": "7.00",        "total": "40320.00"      },      "expiresAt": "2026-10-22T18:00:00Z"    }  ]}