---
title: "Products sold inside LIVE sessions"
method: POST
path: "/lives/products"
tags: ["Lives"]
---

# Products sold inside LIVE sessions

`POST /lives/products`

The per-product breakdown behind one or more LIVE sessions: for each product featured in the session, its LIVE GMV, units sold, orders, average order value, creator commission and refunds. This is the session x product grain — ``POST /lives/list`` gives the session totals, this explains what inside the session earned them. 

Pass the ``key`` values from ``POST /lives/list`` rows in ``live_session_ids`` (up to 50 per request). Results are keyed back by session ID in request order. Sessions with no product rows — including any ID that belongs to a different shop, or a shop still on the legacy LIVE data path — return an empty ``products`` list rather than an error. Single-shop only.

## Request body

- LiveSessionProductsRequest — Body for POST /lives/products. Session IDs travel in the body rather than the path: ``live_session_id`` values are opaque and often all-numeric, and a numeric path segment is read as a ``shop_id`` by the platform's shop-ownership middleware.
  - `live_session_ids` string[], required — LIVE session IDs to break down — the ``key`` field of a POST /lives/list row. Up to 50 per request.

## Response `200`

Successful Response

- LiveSessionProductsResponse
  - `shop_id` integer, required
  - `sessions` LiveSessionProducts[]
    - `live_session_id` string, required
    - `products` LiveSessionProductBreakdown[]
      - `product_id` string, required
      - `product_name` string, nullable
      - `cover` string, nullable
      - `categories` unknown
      - `live_gmv` number
      - `items_sold` integer, nullable
      - `orders` integer, nullable
      - `avg_order_value` number, nullable
      - `commission` number, nullable
      - `refunded_gmv` number, nullable
      - `refunded_items` integer, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/reacherapp/apis/reacher-data-api.md) · [All operations](https://skmtc.dev/reacherapp/apis/reacher-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/reacherapp/reacher-data-api/revisions/3ea20a9f734b/schema)