---
title: "List model pricing"
method: GET
path: "/v1/pricing"
tags: ["Models"]
---

# List model pricing

`GET /v1/pricing`

## Request

- Base URL: `https://api.tokenlab.sh`
- URL: `https://api.tokenlab.sh/v1/pricing`
- Auth: HTTP bearer

Returns the public pricing surface for active models, with optional provider and tag filters.

## Query parameters

- `provider` string
- `tag` string

## Response `200`

Pricing information for matching models

- PricingResponse
  - `object` 'pricing', required
  - `updated_at` string, date-time, required
  - `currency` 'USD', required
  - `data` PricingEntry[], required
    - `model` string, required
    - `provider` string, required
    - `deliveryAvailability` object: Current model availability by delivery tier; omitted when the source projection is unavailable.
      - `verified` boolean, required: Whether this model has eligible TokenLab Verified delivery supply.
      - `official` boolean, required: Whether this model has eligible Official delivery supply.
      - `operations` object
    - `is_lock_price` boolean, required
    - `capabilities` string[], required
    - `aliases` string[], required
    - `input_per_1m_tokens` string, nullable: TokenLab Verified price per 1M input tokens. Omitted when the model has no Verified supply (`deliveryAvailability.verified` is false).
    - `output_per_1m_tokens` string, nullable: TokenLab Verified price per 1M output tokens. Omitted when the model has no Verified supply (`deliveryAvailability.verified` is false).
    - `lock_price_per_request` string, nullable: TokenLab Verified price per request. Omitted when the model has no Verified supply (`deliveryAvailability.verified` is false).
    - `official_input_per_1m_tokens` string, nullable: Official price per 1M input tokens. Requests that Official delivers are billed at this price.
    - `official_output_per_1m_tokens` string, nullable: Official price per 1M output tokens. Requests that Official delivers are billed at this price.
    - `official_lock_price_per_request` string, nullable: Official price per request. Requests that Official delivers are billed at this price.
    - `has_complex_pricing` boolean
    - `supported_operations` string[]
    - `pricing_summary` object, nullable
    - `pricing_provenance` object, nullable

## Other responses

- `400`: Bad Request - Invalid input
- `401`: Unauthorized - Invalid or missing API key
- `500`: Internal Server Error

---

[API](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway.md) · [All operations](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway/revisions/3208bfbcda22?raw)