Skip to main content

Allocates the best available seats in a cart

POST 
/api/v1/eventim/cart/allocateBestSeats

Automatically selects and allocates the best available seats for a specific event session based on the requested criteria. Specify the event, session, and allocation details including category, rate, and quantity. Optionally filter by block, floor, or contingent. Returns the cart and cart item identifiers along with detailed information about each allocated seat.

The allocation algorithm prioritizes contiguous seating when possible and validates that:

  • The event and session are accessible to the current user
  • The requested rates and categories exist with matching price versions
  • For multi-block venues, a BlockId must be provided

Examples​

Success (200)​

{
  "cartId": 45892,
  "cartItemId": 78341,
  "cartItemDetail": {
    "isContiguous": true,
    "seats": [
      {
        "rateId": 2045,
        "amount": 38.00,
        "fees": 3.00,
        "feesDetails": [
          { "colId": 2, "amount": 2.00 },
          { "colId": 3, "amount": 1.00 }
        ],
        "seatProperties": {
          "seatId": 156789,
          "categoryId": 101,
          "floorId": 78790,
          "designationId": 5,
          "doorId": 12,
          "blockId": 78821,
          "tribuneId": 3,
          "accessId": 1,
          "contingentId": 3045,
          "rank": "A",
          "seat": "12",
          "coordX": 125.50,
          "coordY": 80.25,
          "rotation": 0.00,
          "typePhysical": "SEAT"
        }
      },
      {
        "rateId": 2045,
        "amount": 38.00,
        "fees": 3.00,
        "feesDetails": [
          { "colId": 2, "amount": 2.00 },
          { "colId": 3, "amount": 1.00 }
        ],
        "seatProperties": {
          "seatId": 156790,
          "categoryId": 101,
          "floorId": 78790,
          "designationId": 5,
          "doorId": 12,
          "blockId": 78821,
          "tribuneId": 3,
          "accessId": 1,
          "contingentId": 3045,
          "rank": "A",
          "seat": "13",
          "coordX": 130.50,
          "coordY": 80.25,
          "rotation": 0.00,
          "typePhysical": "SEAT"
        }
      }
    ]
  }
}

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​

{
  "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": "eventSessionId", "message": "EventSessionId must be greater than 0" }
  ],
  "errorCount": 1
}

Error 400 - Price version mismatch​

{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "title": "Bad Request",
  "status": 400,
  "detail": "Price version mismatch for category 101 and rate 2045: requested version 1, current version 2"
}

Error 400 - Block ID required for multi-block venue​

{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "title": "Bad Request",
  "status": 400,
  "detail": "BlockId is required for multi-block venues"
}

Error 403 - Forbidden​

{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.4",
  "title": "Forbidden",
  "status": 403,
  "detail": "Access to this event session is not allowed"
}

Error 404 - Category/Rate not found​

{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.5",
  "title": "Not Found",
  "status": 404,
  "detail": "Category 101 with rate 2045 not found for this event session"
}

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

Last updated on by TempsReel CI/CD