# 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](/docs/openapi.yaml) has every field. [All methods](/docs/api-overview).