---
title: "Pricing catalog"
method: GET
path: "/v1/billing/rates"
---

# Pricing catalog

`GET /v1/billing/rates`

## Request

- Base URL: `https://api.turos.app`
- URL: `https://api.turos.app/v1/billing/rates`
- Auth: none required

Returns the public pricing catalog, free allowance metadata, plan metadata, and meter-family rates.

## Response `200`

Public pricing catalog including machine-readable free allowance metadata.

- object
  - `object` 'pricing_catalog', required
  - `requestId` string, required
  - `version` string, required
  - `starterGrant` object, required
    - `object` 'starter_grant', required
    - `planKey` 'sandbox_grant', required
    - `billingState` 'sandbox_grant', required
    - `calls` integer, required
    - `renewable` boolean, required
    - `period` string, nullable
    - `overflowPlanKey` string, required
    - `note` string
  - `plans` object[], required
    - `key` string
    - `displayName` string
    - `kind` string
    - `monthlyPriceUsd` number, nullable
    - `includedCreditsUsd` number: Monthly included usage-credit value for subscription or contract plans. PAYG and free/grant plans return 0.
    - `meterFamilyPrices` object[]

## Other responses

- `default`: Contract-aware error response

---

[API](https://skmtc.dev/turos/apis/turos-api.md) · [All operations](https://skmtc.dev/turos/apis/turos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/turos/apis/turos-api/revisions/a68d3ec80a56?raw)
