Skip to main content

My inventory-hold usage

GET 
/api/v1/cart/hold-usage

The signed-in agent's hold quota across all their carts: holdUsage.active (live holds right now) of holdUsage.max (their configured cap). The cap comes from the agent's agent_hold_cap entry; an agent with no entry — or without the HOLD_WITHOUT_PAY feature — has a max of 0 and cannot place holds. holdUsage.releasesAt is when a hold placed now would release unpaid, so the agent can be told before they take one; it is the same instant the hold then carries on hold.expiresAt. The same block is embedded on every cart response.

Responses​

OK