Pricing

Itemized all-in cost of an offer before committing

The MCP get_price_breakdown tool: amount plus taxes/fees, total, and for a BID the operator's own bid-strength read.

get/api/v1/offers/{offerReference}/price

Request

  • Base URL: https://www.upgradeagent.ai
  • URL: https://www.upgradeagent.ai/api/v1/offers/{offerReference}/price
  • Auth: one of:
    • OAuth 2 (authorization code, authorization URL https://www.upgradeagent.ai/api/oauth/authorize, token URL https://www.upgradeagent.ai/api/oauth/token, scopes: mcp)
    • HTTP bearer

Path parameters

offerReferencestring required

An offerId from the quote's options, or an offerReference (operator order-change id) from a placed offer.

Query parameters

quoteIdstring required

The quote id returned by POST /api/v1/quotes or /api/v1/quotes/secure.

amountnumber

Amount to price (omit for INSTANT).

purchaseType'BID' | 'INSTANT' | 'POINTS'

Response

Breakdown (available=false when itemized pricing isn't offered for this booking).

quoteIdstring required
offerIdstring required
purchaseTypestring required
availableboolean required

False when itemized pricing isn't available for this booking.

pendingboolean

True when the operator hasn't returned itemized taxes/fees yet.

messagestring nullable required

Changes

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