---
title: "Pricing Flow Price"
method: POST
path: "/pricing_flow_price"
tags: ["Market Data"]
---

# Pricing Flow Price

`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

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

## Request body

- object
  - `user_id` string, uuid, required: Authorized user identifier for pricing flows.
  - `query` string: Free-text wine description; required when `lwin` is not provided.
  - `lwin` string: Direct LWIN lookup; required when `query` is not provided.
  - `vintage` string: Optional vintage to guide resolution and routing.
  - `format` string: Bottle format hint used to route pricing logic.
  - `condition` string: Bottle condition hint forwarded to the flow.
  - `pack_size` number: Pack size (alias `packSize`) used for packaging adjustments.
  - `currency` string: Target currency for FX conversion; does not filter pricing sources.
  - `flow_id` string: Specific pricing flow to run; defaults to the lowest-priority flow when omitted.

## Response `200`

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

---

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