Get your cost
Returns what your org's use cost in each period from start until
end, in US dollars, summed by what groupBy names, with the
periods, filters and finality of GET /v1/usage. Without groupBy, each
period is one amount. It covers inference, each request priced at
its model's price when it finished. Only people signed in to the
console can read it.
oauth2 org:readAuthorizationBearer <token>A person's access token, sent as Authorization: Bearer <token>,
from the authorization code flow with PKCE (S256). A CLI on a
machine without a browser can use the device flow (RFC 8628) at
https://auth.confidential.ai/oauth2/device_authorization
instead. Ask for the resource https://api.cloud.confidential.ai
(RFC 8707): a token issued for any other resource, the MCP server's
included, is refused. A token acts for one person in one org, with
the scopes of the person's role there whatever the client asks for,
so ask the authorization server for none of the scopes below; they
are listed so that each operation can name the ones it needs.
Access tokens last minutes, and a refresh token is replaced at every
use.
Scope: org:read
start?stringThe first UTC day to return. Without it, the first day of the current month.
dateend?stringThe UTC day after the last to return, at most 93 days after
start. Without it, tomorrow.
dategranularity?stringHow long each item's period is: a UTC day, the default, an
hour, or a UTC month cut to start and end. By the hour, end
is at most 31 days after start. Open set: another value is refused
with a 400 that lists the values this version takes.
"day"groupBy?array<string>What to sum by besides the period: location, model and
inferenceKey, as GET /v1/usage names them. Open set: another
value is refused with a 400 that lists the values this version
takes.
items <= 3location?array<>Only these locations.
items <= 16model?array<>Only inference with these models, by the id a request names.
items <= 16inferenceKey?array<>Only inference with these inference keys.
items <= 16pageSize?integerThe most items to return.
1 <= value <= 1000010000pageToken?stringThe nextPageToken of the previous page, unchanged. Send the same
filters with it.
1 <= length <= 2048Api-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 <= 500What your org's use cost in each period.
application/json- response
What your org's use cost in each period from start until end.
start*stringThe first UTC day.
dateend*stringThe UTC day after the last.
dateclosedThrough?stringThe end of the last closed hour: the amounts up to it are final, and use after it is not counted yet. Absent before any hour is closed.
date-timeitems*array<>Each period's cost, summed by what groupBy names, by period,
then location, model and key.
nextPageToken?NextPageTokenPass it back as pageToken for the next page. Absent on the last page.
curl -X GET 'https://api.cloud.confidential.ai/v1/cost?start=2026-10-01&end=2026-11-01&granularity=day&groupBy=model&location=us-west-1&model=example%2Fmodel-70b&inferenceKey=ik-7k2m9q4x1bfa&pageSize=10000&pageToken=eyJjIjoiMjAyNi0xMC0yMlQxNzowMjoxMVoiLCJpIjoiaS03azJtOXE0eDFiZmEifQ' \ -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'{ "start": "2026-12-01", "end": "2027-01-01", "closedThrough": "2026-12-03T14:00:00Z", "items": [ { "date": "2026-12-01", "periodStart": "2026-12-01T00:00:00Z", "periodEnd": "2027-01-01T00:00:00Z", "model": "example/model-70b", "amount": "19.85735", "currency": "USD" } ]}List your usage by instance GET
Returns what each of your org's instances used from `start` until `end`, one line per instance, meter and UTC month, or hour with `granularity=hour`: the lines your usage, and your bill, add up to. Lines come oldest first, then by instance and meter. Each counts as `GET /v1/usage` describes, and is final up to `closedThrough`. Hours closed before `linesFrom` have no lines; `GET /v1/usage` has their totals.
Get your billing GET
Returns how your org pays: the status of its Stripe subscription, as Stripe names it, or `none` before an owner has added a payment method with `POST /v1/billing/checkout`. Your usage is billed from the start of the subscription, at the end of each month. Only people signed in to the console can read it.