Fill-in ordering API across brand dealer portals

Replenish best sellers across every brand from one place

Bridge to Brands lets a buyer or a replenishment system check live warehouse availability for the sizes it is short on, then place at-once fill-in orders to the right store ship-to in each brand's dealer portal. One request shape covers every brand; orders are placed only within your caps and confirmation settings, or staged for a buyer to review and place in Bridge.

The loop

Your system (POS, spreadsheet, forecasting tool or AI agent) decides what is short.
POST /v1/brands/{brand}/lookup resolves your UPCs or SKUs to vendor variants with immediate availability and price, up to 200 items per call.
POST /v1/orders with kind: "fill_in", the store’s ship_to_ref, your PO and the lines stages the order in the portal.
Where the brand is verified for submit and you allow it, the order is placed within your caps (status: submitted, with the brand’s order number); otherwise (status: staged_in_portal) a buyer reviews the basket in Bridge and places it there, in a signed-in portal window — never a portal login.

Idempotency keys make retries safe: the same key within 24 hours replays the original response instead of staging a second draft.

Frequently asked questions

What is a fill-in order?

As of 16 October 2026, a fill-in is an in-season replenishment order for sizes and styles a store already carries, shipped from the brand's available warehouse stock (at-once) rather than booked months ahead as a future order.

Can I send fill-ins for several stores?

Yes. As of 16 October 2026, GET /v1/brands/{brand}/ship-tos lists your stores as the brand knows them, and each order names one ship_to_ref. Send one order per store per brand.

What happens if a size sold out between my check and my order?

As of 16 October 2026, the order response lists every line as staged or skipped with a reason, and status is partial when some lines were skipped. Nothing is silently dropped.