Skip to main content

Manually allocates specific seats in a cart for a given event session.

POST 

/api/v1/eventim/cart/allocateManualSeats

Allocates one or more specific seats identified by their seat ID, rate, and price version for a given cart item and event session. If CartId and CartItemId are not provided, a new cart and cart item are created automatically. If only CartId is provided (CartItemId is null), a new cart item is created under the existing cart. Returns the updated list of allocated seats along with any per-seat errors (e.g., seat already taken by another user).

Examples

✅ Success (200)

{
"cartId": 45892,
"cartItemId": 78341,
"cartItemDetail": [
{ "seatId": 156789, "rateId": 2045 },
{ "seatId": 156790, "rateId": 2045 }
],
"errors": []
}

✅ Success (200) - With per-seat errors

{
"cartId": 45892,
"cartItemId": 78341,
"cartItemDetail": [
{ "seatId": 156790, "rateId": 2045 }
],
"errors": [
{ "seatId": 156789, "errorType": "STOCK" }
]
}

❌ 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 422 - Validation failed (missing detail)

{
"type": "https://tools.ietf.org/html/rfc9110#section-15.5.21",
"title": "Validation Failed",
"status": 422,
"detail": "The request contains 1 validation error(s)",
"errors": [
{ "field": "detail", "message": "Detail is required and must not be empty" }
],
"errorCount": 1
}

❌ Error 422 - Validation failed (CartId required when CartItemId is provided)

{
"type": "https://tools.ietf.org/html/rfc9110#section-15.5.21",
"title": "Validation Failed",
"status": 422,
"detail": "The request contains 1 validation error(s)",
"errors": [
{ "field": "cartId", "message": "CartId is required when CartItemId is provided" }
],
"errorCount": 1
}

❌ Error 404 - Cart not found

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

❌ 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