Sign in
P&L

Order-level P&L detail

One row per order x SKU with its fee breakdown, filterable by order source, settled state, product or SKU — the same filters applied by hand to the Seller Center export. Unsettled lines are included by default and their amounts still move.

post/pnl/orders

Request body

start_datestring date nullable

Inclusive paid-date window start.

end_datestring date nullable

Inclusive paid-date window end.

order_source'Video' | 'Product card' | 'Live' nullable

Filter by TikTok's own order-source value.

settledboolean nullable

True = only settled orders, False = only unsettled. Unsettled amounts still move as TikTok settles them.

product_idstring nullable

Filter to one product.

sku_idstring nullable

Filter to one SKU.

limitinteger

Page size.

offsetinteger

Page offset.

Response

Successful Response

shop_idinteger required
seller_idstring required
totalinteger required
limitinteger required
offsetinteger required
selected_fieldsstring[]

The fee columns every row in this page carries, in canonical order. Echoed once per page, not per row: it is provenance for the projection you asked for, so an absent key can be read as 'not requested' rather than 'no data'.

Changes

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