Orders

Estimate order cost

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

post/orders/estimate

Request

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

Request body

duration_minutesnumber required

Estimated audio duration in minutes

Response

Cost estimate

duration_minutesnumber
can_affordboolean
costnumber

Credit the order would use, in USD

ai_bonus_minutes_availableinteger
ai_bonus_minutes_appliedinteger
credits_availablenumber
credits_appliednumber
credits_remaining_afternumber
shortfallnumber

Credit missing, in USD (0 when covered)

blocked_by'insufficient_credits' | 'email_verification_required' | 'agent_capacity_reached'

Present when can_afford is false

messagestring

Example response

{
  "allowance": {
    "reason": "email_not_verified",
    "rate": {
      "orders_at_once": 1,
      "minutes_per_window": 120,
      "window_hours": 5
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.