Get customer cart
GET/api/v1/customers/:customerId/cart
This endpoint retrieves the current cart contents for a specific customer. Returns all active cart items with full product details.
Authentication: Requires a Private API Key (sk_*) passed in the X-API-Key header.
Use Cases:
- Retrieving customer cart for assisted checkout workflows
- Cart abandonment analysis and recovery
- Customer support for cart-related inquiries
- Pre-checkout cart validation and review
- Syncing cart state with external systems
Response Data:
- Cart items with product details (name, image, price, variant info)
- Quantities and individual item totals
- Subtotal, taxes, and grand total
- Availability status for each item
Error Scenarios:
- 404 NOT FOUND: Customer doesn't exist or has no cart (Error code: CUSTOMER_NOT_FOUND or CART_NOT_FOUND)
- 400 BAD REQUEST: Invalid customer ID format (Error code: INVALID_CUSTOMER_ID)
- 401 UNAUTHORIZED: Invalid or missing API key (Error code: INVALID_API_KEY)
- 403 FORBIDDEN: API key doesn't have access to this store (Error code: NO_STORE_ACCESS)
Request​
Responses​
- 200
- 400
- 401
- 403
- 404
- 500
Cart retrieved successfully with all items and details
Invalid customer ID format
Unauthorized - Invalid or missing API key
Forbidden - No access to this store
Customer or cart not found
Internal server error