REreacherapp
P&L

P&L totals for a window

Changed on

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

  • Base URL
    https://api.reacherapp.com/public/v1
  • URL
    https://api.reacherapp.com/public/v1/pnl/summary
  • Auth
    API key in header x-api-key and API key in header x-shop-id

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

  • 291230805105Revision changes
    • breaking

      the / response's property type changed from string to no type for status

    • info

      added subschema #1 subschema #2 to the / response property anyOf list for the response status