---
title: "Custom Transactions"
method: POST
path: "/custom_feed/transactions"
tags: ["Custom Feed"]
---

# Custom Transactions

`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

Fetch aggregated custom transactions using existing authentication and credits.

## Request body

- object
  - `user_id` string, uuid, required: Authorized user identifier for the custom feed dataset.
  - `agg_level` string: Aggregation level; allowed values: vintage, format, volume.
  - `currency` string: Optional target currency for FX conversion only; it does not filter the results.
  - `page_limit` number: Rows per page; clamped between 1 and 500.
  - `page_offset` number: Pagination offset (>= 0).
  - `query` string: Free-text wine description used when resolving without `lwin`.
  - `lwin` string: Direct LWIN filter; optional when `query` is provided.
  - `wine_search` string: Search string applied to stored wine names.
  - `sort_col` string: Optional sort column for the aggregation.
  - `vintages` string[]: Filter to specific vintages.
  - `formats` number[]: Filter to bottle formats by milliliter value.
  - `volumes` number[]: Filter to specific volumes.

## Response `200`

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

---

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