P&L

P&L totals for a window

Window totals as an ordered waterfall, summed from TikTok's own daily P&L series. Rows are bucketed by order PAID date in the shop's Seller Center timezone. Recent days keep moving as orders settle — check data_status for freshness.

post/pnl/summary

Request body

start_datestring date nullable

Inclusive window start (YYYY-MM-DD). Defaults to 29 days before end_date.

end_datestring date nullable

Inclusive window end (YYYY-MM-DD). Defaults to yesterday — the current day is still accumulating.

Response

Successful Response

shop_idinteger required
seller_idstring required
currencystring required
start_datestring required
end_datestring required
days_with_datainteger required

Daily rows that contributed to these totals.

rollupsobject

TikTok's own rollup columns, reported BESIDE the waterfall and deliberately not inside it. total_marketing_cost is exactly gmv_max + affiliate + campaigns + managed_services, so adding it as a waterfall line would double-count all four.

Changes

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