Find GPU 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.
AuthorizationBearer <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
location?array<>Only these locations.
items <= 16tee?array<>Only these TEEs.
items <= 8gpuModel*stringThe GPU model to reserve.
^[a-z0-9]([-a-z0-9]*[a-z0-9])?$1 <= length <= 32gpuCount*integerHow 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.
1 <= value <= 512start?stringThe 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.
date-timeterm*stringThe length of the reservation, as an ISO 8601 count of days. At least P7D and at most P365D.
^P([7-9]|[1-9][0-9]|[12][0-9]{2}|3[0-5][0-9]|36[0-5])D$Api-Version*stringThe 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?stringAn 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.
^[A-Za-z0-9._:-]+$1 <= length <= 128Org-Context?stringAdmin 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.
^org-[a-z0-9]([-a-z0-9]*[a-z0-9])?$5 <= length <= 63Access-Reason?stringAdmin 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.
^[^\x00-\x1F\x7F]+$10 <= length <= 500Up to six offerings, closest to the requested start first. Empty when nothing fits.
application/json- response
At most six offerings. Not paged.
items*array<>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'{ "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" } ]}Buy inference credits POST
Charges your org's saved card for `amount` of inference credits, $5.00 to $999,999.99, on an invoice of its own, and returns the purchase. It is `paid`, and its amount is in the balance, once Stripe confirms the charge, usually before this call returns; it is `failed`, with `failure` saying why, if the card is declined, and nothing is charged. One still `pending` settles within a minute. An org without a payment method answers `402 payment_required`. One with a purchase still pending, or whose inference is invoiced or not billed, answers `409 invalid_state`. A retry with the same `Idempotency-Key` returns the same purchase. Only owners signed in to the console can call it.
List reservations GET
Lists the org's GPU reservations, newest first, in every status.