Skip to main content
POST
Estimate Cost

Authorizations

Authorization
string
header
required

Mixpeek API key, sent as Authorization: Bearer mxp_sk_.... Create one in Studio under Settings → API Keys, or with an admin key via POST /v1/organizations/users/{user_email}/api-keys. A missing header returns 403; an invalid or revoked key returns 401.

Body

application/json
items
EstimateItem · object[]
required

Planned content to ingest

features
string[]

Feature keys to apply (see GET /v1/collections/features)

full_res
boolean
default:false

Opt out of mezzanine normalization (2x multiplier)

Response

Successful Response

placeholder_rates
boolean
required

True until the rate card locks — quote is provisional

line_items
Line Items · object[]
required
total_usd
number
required
batch_minimum_applied
boolean
required
allowance_covered_usd
number
required

How much of this estimate falls inside the remaining pool (directional pre-cutover: the pool is not drawn down yet)

estimated_overage_usd
number
required

Overage beyond the pool, NET of any plan-level overage discount — matches what the invoice will charge

pricing_model
string
default:v2
allowance_pool_usd
number | null

The tier's monthly usage pool, if any

overage_discount_pct
number
default:0

Plan-level overage discount applied (Scale 20%); 0 when the plan has none

overage_discount_usd
number
default:0

Dollar amount the overage discount saved this estimate