> ## Documentation Index
> Fetch the complete documentation index at: https://docs.valmi.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Pricing

> Query pricing and rate plans

## List Rate Plans

<ParamField path="GET" type="string" required>
  /v1/pricing/rate-plans
</ParamField>

List all rate plans.

<ResponseField name="rate_plans" type="array">
  List of rate plans
</ResponseField>

<RequestExample>
  ```bash theme={null}
  curl -X GET https://api.valmi.io/v1/pricing/rate-plans \
    -H "Authorization: Bearer sk_api_abc123xyz"
  ```
</RequestExample>

## Get Rate Plan

<ParamField path="GET" type="string" required>
  /v1/pricing/rate-plans/{rate_plan_id}
</ParamField>

Get details of a specific rate plan.

<RequestExample>
  ```bash theme={null}
  curl -X GET https://api.valmi.io/v1/pricing/rate-plans/plan_abc123 \
    -H "Authorization: Bearer sk_api_abc123xyz"
  ```
</RequestExample>

## Simulate Pricing

<ParamField path="POST" type="string" required>
  /v1/pricing/simulate
</ParamField>

Simulate pricing for sample usage.

### Body

<ParamField body="rate_plan_id" type="string" required>
  Rate plan ID
</ParamField>

<ParamField body="usage" type="object" required>
  Sample usage data
</ParamField>

<ResponseField name="charges" type="array">
  Calculated charges
</ResponseField>

<ResponseField name="total" type="number">
  Total charge amount
</ResponseField>

<RequestExample>
  ```bash theme={null}
  curl -X POST https://api.valmi.io/v1/pricing/simulate \
    -H "Authorization: Bearer sk_api_abc123xyz" \
    -H "Content-Type: application/json" \
    -d '{
      "rate_plan_id": "plan_abc123",
      "usage": {
        "tokens": 50000,
        "api_calls": 1000
      }
    }'
  ```
</RequestExample>