Skip to main content

Retrieves the poster image for a specific event.

GET 

/api/v1/eventim/catalog/events/poster/:eventId

Fetches the poster image associated with an event identified by its event ID. The image is returned as a base64-encoded byte array. Image format can be JPG, PNG or GIF. Returns null for events that exist but have no poster image configured.

Examples

✅ Success (200) - Event with poster

{
"picture": "R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7..."
}

✅ Success (200) - Event without poster

{
"picture": null
}

❌ 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": "eventId", "message": "EventId must be greater than 0" }
],
"errorCount": 1
}

❌ Error 403 - Event not allowed

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

❌ 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 while processing your request.",
"traceId": "00-1234567890abcdef1234567890abcdef-1234567890abcdef-01"
}

Request

Responses

OK