---
title: "List per-provider price overrides"
method: GET
path: "/v1/projects/{project_id}/ai-providers/{ai_provider_id}/prices"
tags: ["AI Providers"]
---

# List per-provider price overrides

`GET /v1/projects/{project_id}/ai-providers/{ai_provider_id}/prices`

## Request

- Base URL: `https://api.naturali.ai`
- URL: `https://api.naturali.ai/v1/projects/{project_id}/ai-providers/{ai_provider_id}/prices`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://api.naturali.ai/authorize`, token URL `https://api.naturali.ai/token`, scopes: `mcp:access`)

Returns the per-provider price overrides for this AI provider instance. An override prices this specific provider (e.g. an enterprise-negotiated rate or a gateway with markup) and wins over the global default at cost time. Authorized by the caller's access to the provider's project — so, unlike the global price book, a project's own overrides are visible here.

## Path parameters

- `ai_provider_id` string, required

## Response `200`

The provider's price overrides

- ProviderPricesResponse
  - `prices` ProviderPrice[]
    - `id` string: Public ID of the price row
    - `ai_provider_id` string: The AI provider instance this override prices
    - `meter_type` string: Always `llm_tokens` for provider price overrides
    - `provider` string: Provider slug (taken from the AI provider instance)
    - `model` string
    - `component` string: The token component this row prices (`input_tokens`, `output_tokens`, `cached_tokens`, `cache_write_tokens`)
    - `unit` string: Always `token` for provider price overrides
    - `unit_price` number: USD per token for this component
    - `effective_from` string, date-time: The row with the latest effective_from <= now() prices a call
    - `created_at` string, date-time

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: AI provider not found

---

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