How much of this book can still walk
How much of a season's committed value is firm, how much can still walk, and how much nobody has said: the three-way split for the scope, the same split per account ordered by walkable value, and the date each piece stops being walkable.
On wholesale, committed is a retailer's option: a booked order inside its cancellation window can still walk, so open to buy computed as envelope minus committed overstates what is safe. season_code is required; commitment_id and as_of narrow as elsewhere.
Three buckets, never two. unknown is value on accounts with no recorded cancellation term, or on an in-window line with no cancel date, and it is folded into neither firm (which would keep the overstatement) nor walkable (which would invent an exposure). An unshipped line past its cancel date (the trade's cancel-after day) is walkable, never firm: the retailer may refuse it. Soft lines, drafts and holds, are in none of the three and not in committed either: they are served in their own soft block with value summed over priced lines only.
firmness is null when the scope has no book at all. A season whose every line is cancelled is a true zero and is served as one.
This says what CAN walk. get_order_book_signals says what IS walking, the claims retailers have actually made, and get_order_book_summary carries the same totals beside the envelope.
Sold with Essentials+: without Tightly Connect the answer is 403 plan_excludes.
Scope: order_book:read.
Request
- Base URL: https://api.app.tightly.io
- URL: https://api.app.tightly.io/api/v1/order-book/firmness
- Auth: HTTP bearer
Query parameters
The season being read, e.g. SS27.
Narrow the book to one Commitment's scope.
Reconstruct the book at this instant AND measure every cancel date against that day. There is deliberately no second "as at" parameter: two dates in one reading is how a response comes to describe a book from March against a calendar from August.
Headers
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 three-way split for the scope, the same split per account, and the walkable value by the date each piece stops being walkable. measured_on is the day the cancel dates were compared against, fixed from as_of rather than taken from the session's clock.
Changes
No recorded changes to this operation across all 1 revision of this API.