finance_reports

The Monday pack for one 4-5-4 retail week

The Monday pack for one 4-5-4 retail week, as one read. Eight bands: the ledger's lines for this week, last week, month to date and year to date, each against the plan and against the same fiscal week last year; where the move came from, cut by category, channel or commitment; best and worst sellers; the full-price and markdown mix; size availability; aged stock; future intake by week; and this week's breached and watched commitment verdicts.

EVERY HEAD FIGURE FOOTS. foots_to is the address of the row and column the figure was counted off, so a head can be tied to the band beneath it rather than taken on trust.

EVERY BAND CARRIES ITS OWN as_of AND data_source. Eight reads taken at eight moments have eight freshnesses, and one stamp at the top would date the stalest with the freshest's.

LAST YEAR IS A FISCAL WEEK, NOT A DATE. Where this year runs 53 weeks and last year ran 52, week 53 is read against last year's week 52 and period_detail.last_year.alignment says restated_week_53 with the sentence beside it.

ABSENCE IS A WORD. A band whose read is not built yet carries unsupported_reason; an empty band carries one absence sentence; a plan cell with no line reads No plan and never a zero.

Scope: reports:read.

get/api/v1/finance/reports/weekly-trade

Request

  • Base URL: https://api.app.tightly.io
  • URL: https://api.app.tightly.io/api/v1/finance/reports/weekly-trade
  • Auth: HTTP bearer

Query parameters

weekstring required

A fiscal year and a fiscal week, written 2026-W23.

cut'category' | 'channel' | 'commitment'

How the "where the move came from" band is broken. Defaults to category.

plan_idstring

Published plan in the selected fiscal year. Omit to use the unique published plan; multiple plans require an explicit selection.

Headers

Tightly-Versionstring
Example:2026-11

The date train to answer on. One train exists today, 2026-11, the one this reference describes and the one every key is minted on, so the call answers on it with or without this header. Send it anyway, so a client built now names its train from the start.

Response

The weekly trade report

Changes

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