Endpoint to generate a venue seating plan picture with customizable seat and border colors

POST /api/v1/eventim/catalog/venues/picture/color

Fetch a PNG image of the venue seating plan with custom colors. Returns a picture property as a byte array base64 encoded. This endpoint allows full customization of seat appearance including:

Custom RGB colors for seats (0-255 for each component)
Configurable border width (0 = no border)
Custom RGB colors for borders
Adjustable zoom level (0.2x to 5x)
Display mode (with or without seat letters)

SOAP Equivalent: AWSP_VenueGetPictureMapWithColor

Examples

✅ Success (200)

{
  "picture": "iVBORw0KGgoAAAANSUhEUgAA...ABJRU5ErkJggg=="
}

❌ 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",
  "instance": "/api/v1/catalog/venues/picture/color",
  "traceId": "00-a1b2c3d4e5f6-7890abcdef-00"
}

❌ Error 422 - Validation failed

{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.23",
  "title": "One or more validation errors occurred.",
  "status": 422,
  "errors": {
    "VenueId": ["VenueId must be greater than 0"],
    "Zoom": ["Zoom must be between 0.2 and 5.0"],
    "SeatColor.R": ["SeatColor.R must be between 0 and 255"],
    "BorderWidth": ["BorderWidth must be 0 or greater"]
  },
  "instance": "/api/v1/catalog/venues/picture/color",
  "traceId": "00-f1e2d3c4b5a6-9876543210-00"
}

❌ Error 404 - Venue not found

{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.5",
  "title": "No venue found",
  "status": 404,
  "detail": "The venue id doesn't exist for the client",
  "errorCode": 10103,
  "instance": "/api/v1/catalog/venues/picture/color",
  "traceId": "00-1a2b3c4d5e6f-0987654321-00"
}

❌ Error 500 - Server error

{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.6.1",
  "title": "An error occurred while processing your request.",
  "status": 500,
  "detail": "Failed to generate venue image",
  "errorCode": 10210,
  "instance": "/api/v1/catalog/venues/picture/color",
  "traceId": "00-9z8y7x6w5v4u-3210fedcba-00"
}

SOAP to REST Field Mapping

REST Field	SOAP Field	Notes
`seatColor.r`	`R`	Red component of seat color (0-255)
`seatColor.g`	`G`	Green component of seat color (0-255)
`seatColor.b`	`B`	Blue component of seat color (0-255)
`borderWidth`	`borderWidth`	Border width in pixels (≥0)
`borderColor.r`	`borderR`	Red component of border color (0-255)
`borderColor.g`	`borderG`	Green component of border color (0-255)
`borderColor.b`	`borderB`	Blue component of border color (0-255)
`venueId`	`id_venue`	Venue unique identifier
`option`	`option`	800 (numbers+letters) or 801 (numbers only)
`zoom`	`zoom`	Zoom factor (0.2 to 5.0)
`picture`	`picturebytes`	Base64 encoded PNG image
`errorCode`	`result`	Error code (0 = success, see SOAP doc Annex 1)

Endpoint to generate a venue seating plan picture with customizable seat and border colors

/api/v1/eventim/catalog/venues/picture/color

Examples​

✅ Success (200)​

❌ Error 400 - Missing x-tenant header​

❌ Error 422 - Validation failed​

❌ Error 404 - Venue not found​

❌ Error 500 - Server error​

SOAP to REST Field Mapping​

Request​

Responses​