Skip to content

Cart API ​

Use the Cart API to manage the shopping cart of a customer. A customer can be authenticated or a guest.

WARNING

The V1 cart endpoints (/v1/carts/*) are removed. The API returns 410 Gone. See Migrate from V1 to V2.

Authentication ​

  • An authenticated customer sends the Authorization: Bearer JWT_TOKEN header.
  • A guest customer sends the X-Session-Id header. To get a session ID, use Generate Cart Session ID.
  • Every request must have the X-MerchantApiKey header.
  • If a request has no token and no session ID, the API returns 400: "Please log in or start a guest session to continue."

Endpoints ​

EndpointMethodPath
Generate Cart Session IDGET/v1/generate/session/id
Cart V2 endpoints/v2/carts/*
Add Item to CartPOST/v2/carts/add
Replace Booking TimePATCH/v2/carts/booking/{cartItemId}
CheckoutPOST/v2/carts/checkout, /v2/carts/guest/checkout

Next steps ​

Build with joy