Automatically allocates the best available seats for an event session.
POST/api/v1/cart/allocateBestSeats
SOAP Equivalent: ACP_AllocSeatsAutomatic (id_Package == 0 branch → WSM_AllocSeatsAutomatic).
Each allocation detail (categories, optional contingent/block/floor filters, and a quantity)
produces one group of seats in the response with its own contiguity flag. Pass the returned
cartId in subsequent calls to add seats to the same cart, or 0 to create a new cart.
On an allocation shortfall (not enough seats) the seats reserved by the current call are released and error code 10112 is returned.
Scope: seats are returned unpriced (rate id 0) with their identifiers only; call
GET /api/v1/cart/{cartId} for the full seat detail. The sale price grid, category/rate
rights, validation rules and card rules of the legacy method are not ported. Subscription
allocation (id_Package > 0) is a separate concern and is not supported by this endpoint.
SOAP to REST Field Mapping
| REST Field | SOAP Field | Notes |
|---|---|---|
| cartId | id_TemporaryOrder | 0 creates a new cart |
| cartItemId | id_TemporaryOrderRow | Created InterfaceFlag identifier |
| eventId | id_Catalog | Event identifier |
| eventSessionId | id_CatalogDate | Event session identifier |
| detail | listAllocRequest | One allocation per detail |
| detail[].categoryIds | ListID_Category | Multiple categories allowed |
| detail[].contingentIds | ListID_Contingent | Optional filter |
| detail[].blockIds | ListID_Bloc | Optional filter |
| detail[].floorIds | ListID_Floor | Optional filter |
| detail[].quantity | ListQuantity[].Quantity | Total seats (rates out of scope) |
| groups | listAllocResponse | One group per detail |
| groups[].isContiguous | isContiguous | Contiguity of the group |
| groups[].seats | ListAllocSeat | Allocated seats (identifiers) |
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 422
- 500
OK
Bad Request
Unauthorized
Forbidden
Not Found
Unprocessable Content
Internal Server Error