Custom Feed

Custom Transactions

Fetch aggregated custom transactions using existing authentication and credits.

post/custom_feed/transactions

Request

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

Request body

user_idstring uuid required

Authorized user identifier for the custom feed dataset.

agg_levelstring

Aggregation level; allowed values: vintage, format, volume.

currencystring

Optional target currency for FX conversion only; it does not filter the results.

page_limitnumber

Rows per page; clamped between 1 and 500.

page_offsetnumber

Pagination offset (>= 0).

querystring

Free-text wine description used when resolving without lwin.

lwinstring

Direct LWIN filter; optional when query is provided.

wine_searchstring

Search string applied to stored wine names.

sort_colstring

Optional sort column for the aggregation.

vintagesstring[]

Filter to specific vintages.

formatsnumber[]

Filter to bottle formats by milliliter value.

volumesnumber[]

Filter to specific volumes.

Response

Response highlights:

  • limit, offset, count: pagination metadata echoed from the service.
  • results[]: aggregated custom transaction rows.
  • results[] fields include id, created_at, upload_id, wine_name, vintage, format, volume, raw_format, bottle_price, price, matching_attempted, offer_type, condition, packaging, quantity, ordered_at, source_id, user_id, currency_code, expiration_date, source_name, email_address.

Notes:

  • Currency input converts returned prices only; it never filters the underlying custom rows.
object required

Changes

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