Skip to main content

Removes products from a cart

POST 

/api/v1/eventim/cart/removeProducts

Removes a specified quantity of a product from an existing cart item. Products can be removed globally or scoped to a specific event session:

  • Global products: Omit both EventId and EventSessionId. The product is removed from the cart without session filtering.
  • Session-scoped products: Provide both EventId and EventSessionId. The product removal is linked to that specific event session.

EventId and EventSessionId must be provided together or both omitted. When the quantity to remove is greater than or equal to the current quantity, the cart item quantity is set to zero. The response includes the updated cart item details with pricing breakdown, including base amount (per unit) and itemized fees.

Examples

Success (200) - Partial removal of a session-scoped product

{
"cartId": 45892,
"cartItemDetail": {
"cartItemId": 12034,
"productId": 80075,
"eventId": 57,
"eventSessionId": 89,
"quantity": 1,
"amount": 15.00,
"fees": 2.50,
"feesDetails": [
{ "colId": 2, "amount": 1.50 },
{ "colId": 3, "amount": 1.00 }
]
}
}

Success (200) - Complete removal of a global product

{
"cartId": 45892,
"cartItemDetail": {
"cartItemId": 12035,
"productId": 80073,
"quantity": 0,
"amount": 25.00,
"fees": 0.00,
"feesDetails": []
}
}

Error 400 - Missing x-tenant header

{
"type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
"title": "Bad Request",
"status": 400,
"detail": "Tenant header 'x-tenant' is required"
}

Error 400 - Validation failed

{
"type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
"title": "Bad Request",
"status": 400,
"detail": "CartItemId must be greater than 0"
}

Error 400 - EventId and EventSessionId mismatch

{
"type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
"title": "Bad Request",
"status": 400,
"detail": "EventId and EventSessionId must be both set or both null"
}

Error 404 - Cart not found

{
"type": "https://tools.ietf.org/html/rfc9110#section-15.5.5",
"title": "Not Found",
"status": 404,
"detail": "Cart with ID 45892 was not found",
"errorCode": 12004
}

Error 404 - Product not found in cart item

{
"type": "https://tools.ietf.org/html/rfc9110#section-15.5.5",
"title": "Not Found",
"status": 404,
"detail": "Product with ID 80075 was not found",
"errorCode": 10400
}

Error 404 - No cart item for session

{
"type": "https://tools.ietf.org/html/rfc9110#section-15.5.5",
"title": "Not Found",
"status": 404,
"detail": "No active cart item found for cart 45892 in the current session",
"errorCode": 13007
}

Error 500 - Server error

{
"type": "https://tools.ietf.org/html/rfc9110#section-15.6.1",
"title": "Internal Server Error",
"status": 500,
"detail": "An unexpected error occurred",
"traceId": "00-a1b2c3d4e5f6-789012345678-00"
}

Request

Responses

OK