Get Cart
GET/api/portal/cart
Return the active account's cart, re-priced and re-validated. Each line reports its current unit price, line total, availability, and any warnings; the cart reports subtotal and minimum-order-value progress.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Each warning is an object: code (price_changed, backordered, insufficient_stock, out_of_stock), message (a ready-to-display sentence, which for the stock codes names the quantity actually available), and blocks_checkout (true for insufficient_stock and out_of_stock — those lines are rejected by Submit Checkout until the quantity is reduced).
subtotal is always the pre-discount goods total. When the account has an order-value discount ladder, order_discount reports the tier earned at that subtotal (percent/amount/min_subtotal, all null below the first tier) and the next tier up (next_percent/next_min_subtotal/next_remaining, all null at the top of the ladder). total is subtotal less amount — what the buyer pays before tax and shipping, and equal to subtotal when no ladder applies.
Request
Responses
- 200
- 401
- 403
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.