---
title: "Match To LWIN"
method: POST
path: "/match_to_lwin"
tags: ["Matching"]
---

# Match To LWIN

`POST /match_to_lwin`

## Request

- Base URL: `https://external-api.wine-labs.com`
- URL: `https://external-api.wine-labs.com/match_to_lwin`
- Auth: none declared

Resolve a single wine search query to LWIN codes, a [Wine Labs ID](/wine-labs-id) and a normalized display label.

## Request body

- object
  - `user_id` string, uuid, required: Account identifier issued during onboarding; used for authentication and quota tracking.
  - `query` string: Wine name, producer, vintage, or other descriptive text to resolve. Required when `lwin` and `wl_id` are not provided.
  - `lwin` string: Direct LWIN lookup. Required when `query` and `wl_id` are not provided.
  - `wl_id` string: Wine Labs wine identifier. Required when `query` and `lwin` are not provided.

## Response `200`

Response highlights:
- `lwin7`: base 7-digit LWIN code when a match is found.
- `lwin`: longest available LWIN including vintage or format detail.
- `display_name`: normalized wine name suitable for customer-facing views.
- `wl_id`: the [Wine Labs ID](/wine-labs-id), the canonical identifier covering 813K+ wines and spirits.

Notes:
- Returns null values for all fields when the query cannot be matched.
- Usage limit: up to 30,000 matched rows per rolling 30 days across matching endpoints.

- 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)