Every trading account, with its terms and how it is trading
Every trading account, with the identity a sell-out write and an order-book read both name an account from: its id, the account's own buyer reference, its name, its sales channel, transit time, when its data last synced, its standing terms (tier, fill-rate target, cancellation term and notice days), the next estimated order date, the trading figures read off its own reports, and portal_seats, the account's side of the buyer's portal: how many buyers hold a live seat, how many invitations are still unopened, and when any of them last opened it.
retailer_ids narrows to named accounts and variant_id narrows the trading figures to one variant.
Absence is never coerced. account_tier null means untiered and fill_rate_target_pct null means no promise is published; an untiered account read as the lowest tier would be deprioritised in a shortage by a policy nobody wrote. cancellation_term null is silence rather than none: read as "no term", the account's whole book would count as unwalkable and open to buy would be overstated by exactly the value that can still cancel, so cancellation_term_note carries the absence instead.
accepts_855/856/810 null: nobody asked.
Use this to resolve an account id before posting sell-out. The writes on this prefix configure the integration rather than describe an account, and are not public.
Sold with Essentials+: without Tightly Connect the answer is 403 plan_excludes. A key issued to one account sees that account alone here.
Scope: accounts:read.
Request
- Base URL: https://api.app.tightly.io
- URL: https://api.app.tightly.io/api/v1/wholesale/retailers
- Auth: HTTP bearer
Query parameters
Restrict to these accounts, comma-separated.
Only accounts that carry this variant, which accounts stock it.
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
retailers, one row per account, with identity, channel, terms, the cadence of its orders, the trading figures read off its own reports and, where the seat store answered, portal_seats with accepted, invited and last_opened_at.
sales_velocity_per_week is null where none of the account's recent weekly periods carries a units-sold figure: it reports only whole calendar months, reports stock without sales, or has not reported yet. A month is never divided into weeks, and a week that sold nothing still reads 0.
Changes
No recorded changes to this operation across all 1 revision of this API.