---
title: "Quote request cost"
method: POST
path: "/v1/billing/quote"
---

# Quote request cost

`POST /v1/billing/quote`

## Request

- Base URL: `https://api.turos.app`
- URL: `https://api.turos.app/v1/billing/quote`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Quote a billable workflow or meter class against the current billing plan and budget gates.

## Request body

- object
  - `planKey` string, nullable: Optional public plan key to quote instead of the organization's current plan.
  - `meterClass` string, nullable: Optional meter class. Provide this or a path.
  - `path` string, nullable: Optional API path used to derive the meter class. Provide this or meterClass.
  - `method` string, nullable: HTTP method used with path; defaults to GET when path is supplied.
  - `units` number, nullable: Optional positive number of units to quote.

## Response `200`

Successful response

- object
  - `object` 'billing_quote', required
  - `planKey` string, required
  - `meterClass` string, required
  - `meterFamily` string, required
  - `units` integer, required
  - `unitAmountUsd` number, required
  - `amountUsd` number, required
  - `amountCents` integer, required
  - `currency` 'usd', required
  - `requestId` string, required
  - `budget` object, required
  - `budgetGate` object, nullable, required

## 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)