Market Data

Pricing Flow Price

Execute your configured pricing flow (lowest priority when unspecified) using existing authorizations and credits; configure flows via Pricing Flow Builder.

post/pricing_flow_price

Request

  • Base URL: https://external-api.wine-labs.com
  • URL: https://external-api.wine-labs.com/pricing_flow_price
  • Auth: none declared

Request body

user_idstring uuid required

Authorized user identifier for pricing flows.

querystring

Free-text wine description; required when lwin is not provided.

lwinstring

Direct LWIN lookup; required when query is not provided.

vintagestring

Optional vintage to guide resolution and routing.

formatstring

Bottle format hint used to route pricing logic.

conditionstring

Bottle condition hint forwarded to the flow.

pack_sizenumber

Pack size (alias packSize) used for packaging adjustments.

currencystring

Target currency for FX conversion; does not filter pricing sources.

flow_idstring

Specific pricing flow to run; defaults to the lowest-priority flow when omitted.

Response

Response highlights:

  • flow_id: pricing flow identifier executed for the request.
  • price, bottle_price, adjusted_price, currency: returned pricing with packaging adjustments when applicable.
  • data_source, aggregation: source and aggregation used to derive the price.
  • applied_modifiers, path: modifiers and routing path applied within the flow.
  • resolved_lwin, resolved_vintage: resolved wine context.
  • confidence_score, record_count: diagnostics for the derived price.
  • format_detected, case_size_detected: detected packaging cues from the request.
  • trace: per-node execution details including router matches and intermediate prices.

Notes:

  • Provide either query or lwin to resolve the wine; flows return 404 when no wine or price can be derived.
  • Currency input only converts returned values; it never filters underlying records.
  • When flow_id is provided that specific flow is used; otherwise the user's lowest-priority pricing flow runs.
object required

Changes

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