Skip to main content
POST
Adds items to cart

Path Parameters

cart_token
string
required

Body

application/json
items
object[]
required
perform_cart_calculations
boolean

Whether to run cart calculations after adding items (defaults to true)

enrollment
object

Claim an enrollment pack and add its items before the items above, in one request. Equivalent to calling the /enrollment endpoint first — same body, same conflict semantics (409 while an identical enrollment is in progress, 409 on a differing configuration, 404 for an unknown or inactive pack) — but it saves a round trip and returns one cart covering both. The /enrollment endpoint remains supported.

include_checkout_context
boolean

When false, the response cart omits the checkout-decision fields (valid_for_checkout, valid_for_checkout_pre_payment, payment_method, payment_method_auto_assignable, shipping_method, available_shipping_methods, available_payment_methods), skipping their computation. Defaults to true. A client that stores the cart and renders totals without reading those fields can send false to skip their computation.

Response

Success

cart
object
required
meta
object | null
required
skipped_items
object[]

Items that could not be added (e.g. out of stock or unavailable in the cart's country). Present only when at least one item was skipped.