List prices

The rate card every call is priced against.

Lists the rate card.

Request

  • GET /v1/priceableUnits

Parameters

Name In Type Required What it is
pageSize query integer no Maximum priceable units to return.
pageToken query string no A page token from a previous response, to retrieve the next page.

Response

Field Type What it is
priceableUnits list of object The priceable units in this page.
nextPageToken string Token to retrieve the next page, empty when there are no more.

Each item of the list

Field Type What it is
name string The resource name of the priceable unit.
displayName string Human-readable name, e.g. Gemini 2.5 Pro output tokens.
provider string The provider that charges for it.
model string The model this rate applies to, where the charge is per model.
kind enum What is being counted.
unitCostNanos int64 as string Cost of one unit, in billionths of a US dollar.
effectiveFrom timestamp When this rate takes effect, inclusive.
rateCardVersion string The rate card version this belongs to, recorded on every activity priced with it, e.g. 2026-09.
unitCostMicros int64 as string Deprecated: too coarse to hold a real rate.
serviceTier string The service tier this rate is for, e.g. BATCH, FLEX, PRIORITY.
minPromptTokens integer The smallest prompt this rate applies to, in tokens.
minCacheWriteTtlSeconds integer The shortest cache lifetime this rate applies to, in seconds.
modality string The modality this rate is for, e.g. AUDIO, IMAGE, VIDEO, DOCUMENT.
region string The processing region this rate is for, matched against Activity.region, e.g. us, eu.
effectiveTo timestamp When this rate stops applying, exclusive.
source string Where the rate came from, e.g. a link to the provider's public price list.
etag string Entity tag.
createTime timestamp When this rate was created.
updateTime timestamp When this rate was last updated.

The OpenAPI document has every field. All methods.