---
title: "Creator LIVE-attributed GMV window totals"
method: POST
path: "/lives/summary"
tags: ["Lives"]
---

# Creator LIVE-attributed GMV window totals

`POST /lives/summary`

Window totals for creator LIVE-attributed GMV for one shop, from ``customers.live_sessions`` (the Affiliate Center LIVE value shops see on /insights/transaction-analysis → LIVE streams). 

**Differs from POST /metrics/summary field ``gmv``** — that is ALL affiliate revenue (video + live + product card). This isolates the LIVE-stream slice only. The ``live_gmv`` field on /metrics/summary is the same number as a simple cross-shop scalar; this endpoint adds per-shop currency, session count, engagement and viewing duration. 

Single-shop only — set ``x-shop-id`` to a specific shop ID. Defaults to the last 30 days ending today. Empty totals (``live_count`` 0) are a normal 200 response — live-session coverage is data-presence driven.

## Request body

- LivesSummaryRequest — POST /lives/summary request body. Creator LIVE-attributed GMV window totals for one shop (customers.live_sessions) — single shop, currency- aware.
  - `start_date` string, date, nullable — Inclusive window start (YYYY-MM-DD). Defaults to 29 days before ``end_date`` (30-day window).
  - `end_date` string, date, nullable — Inclusive window end (YYYY-MM-DD). Defaults to today (live sessions can land same-day, unlike the Seller Center daily rollup).

## Response `200`

Successful Response

- LivesSummaryResponse — Window totals for creator LIVE-attributed GMV (customers.live_sessions) for one shop. Single shop only; ``currency_code`` is per-shop.
  - `shop_id` integer, required
  - `currency_code` string, nullable — ISO currency code applying to the window (e.g. 'USD', 'GBP'). ``null`` when the window has no live-session data or (defensively) when rows somehow mix currencies for the same shop.
  - `start_date` string, required
  - `end_date` string, required
  - `live_count` integer, required — Number of affiliate LIVE sessions in the window.
  - `live_gmv` number, required — SUM of creator LIVE-attributed GMV (``affiliate_gmv``) across the window — the Affiliate Center LIVE value.
  - `items_sold` integer, required — SUM of affiliate units sold across LIVE sessions.
  - `avg_engagement_rate` number, nullable — Window-level engagement rate as a decimal (0.0–1.0+): SUM(likes+comments+shares) / SUM(views). ``null`` when views are 0. Not the average of per-session rates.
  - `avg_viewing_duration` integer, nullable — Average viewing duration in seconds across LIVE sessions; ``null`` when empty.

## 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/5eefff009b5b/schema)