---
title: "Estimate order cost"
method: POST
path: "/orders/estimate"
tags: ["Orders"]
---

# Estimate order cost

`POST /orders/estimate`

## Request

- Base URL: `https://barevalue.com/api/v1`
- URL: `https://barevalue.com/api/v1/orders/estimate`
- Auth: HTTP bearer

Calculate the cost breakdown for an order of a given duration, including bonus minutes, subscription minutes, and overage charges.

## Request body

- EstimateRequest
  - `duration_minutes` number, required: Estimated audio duration in minutes

## Response `200`

Cost estimate

- EstimateResponse: Whether an AI order of this length would be accepted, from the same sources submit bills against.
  - `duration_minutes` number
  - `can_afford` boolean
  - `cost` number: Credit the order would use, in USD
  - `ai_bonus_minutes_available` integer
  - `ai_bonus_minutes_applied` integer
  - `credits_available` number
  - `credits_applied` number
  - `credits_remaining_after` number
  - `shortfall` number: Credit missing, in USD (0 when covered)
  - `allowance` AgentAllowance: Limits on an account whose email is not verified yet. `limited` is false once verified.
    - `limited` boolean, required
    - `reason` string
    - `minutes_remaining` number
    - `orders_remaining` integer
    - `minutes_limit` integer
    - `orders_limit` integer
    - `window_days` integer
    - `how_to_lift` string
    - `rate` object: How fast the allowance may be used. A value is null when that limit is not in force.
      - `orders_in_progress` integer
      - `orders_at_once` integer, nullable
      - `minutes_per_window` integer, nullable
      - `window_hours` integer
      - `window_minutes_remaining` number, nullable
  - `blocked_by` 'insufficient_credits' | 'email_verification_required' | 'agent_capacity_reached': Present when can_afford is false
  - `message` string

## Other responses

- `401`: Missing or invalid API key
- `422`: Validation failed

---

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