---
title: "Auctions"
method: POST
path: "/auctions"
tags: ["Auctions & Exchange"]
---

# Auctions

`POST /auctions`

## Request

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

Access historical auction results from the supported self-serve auction dataset or your custom authorized scopes.

## Request body

- object
  - `user_id` string, uuid, required: Authorized user identifier used for plan-based authentication and quota tracking.
  - `auction_provider_ids` number[]: Filter results to specific auction providers.
  - `query` string: Free-text wine description; optional when providing identifiers.
  - `lwin` string: Direct LWIN filter.
  - `vintage` string: Vintage filter.
  - `lot_id` string: Internal Wine Labs lot identifier.
  - `auction_lot_id` string: Provider-specific lot identifier.
  - `auction_id` string: Auction event identifier.
  - `sold_date_from` string, date: Inclusive lower bound for sold date.
  - `sold_date_to` string, date: Inclusive upper bound for sold date.
  - `limit` number: Page size (1–500).
  - `offset` number: Pagination offset (>= 0).
  - `sort_by` string: Sort options: sold_date, auction_date, hammer_price_usd, realised_price_usd, bottle_price_usd, auction_id.
  - `sort_direction` string: Sort direction: asc or desc.

## Response `200`

Response highlights:
- `limit`, `offset`, `count`, `total_available`: pagination metadata.
- `results[]`: auction lots with provider info, hammer prices (native and USD), bottle price, currency, and resolved wine identifiers.

Notes:
- Self-serve auction plans include the supported auction-provider dataset with no provider-level conditions applied.
- Usage limits depend on your active auction subscription and renew each billing cycle.
- Custom plans are available when you need bespoke scopes, limits, or integration support.

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