Events

Retrieve a list of all events (or a specific event) for a given client. Events are grouped: each main event contains an array of sub events (individual performances with dates and times).

GET /v1/:client_name/events/:event_id

List all main- and sub-events, or a specific event.

Path parameters

Name	Type	Description
client_name	string	The short name identifying you as a VdM client (e.g. demo or fringe).
event_id	string, optional	ID of a specific main- or sub-event. Or use the string upcoming to filter on future events.

Responses

200 OK — events successfully retrieved.

[
  {
    "event_id": 94,
    "event_name": "VoordeMensen Demo Event",
    "event_text": "Extra text",
    "event_short_text": "Subtitle or company name",
    "event_image": null,
    "sub_events": [
      {
        "event_id": 95,
        "event_name": "VoordeMensen Demo Event",
        "event_text": "Extra text",
        "event_short_text": "Subtitle or company name",
        "event_url": null,
        "event_image": null,
        "event_date": "2026-04-01",
        "event_time": "20:30:00",
        "event_end": "22:30:00",
        "event_view_end": "0000-00-00 00:00:00",
        "event_rep": "sub",
        "event_main_id": 94,
        "event_free": 10,
        "event_status": "pub",
        "location_id": 1,
        "location_name": "Bellevue Grote Zaal"
      }
    ]
  }
]

404 Not Found — event ID not found:

{ "message": "Event not found" }

Response fields

Main event

Field	Type	Description
event_id	integer	Unique main event ID
event_name	string	Event name
event_text	string	Full description
event_short_text	string	One-line subtitle
event_image	string | null	URL to event image
sub_events	array	List of sub-events (see below)

Sub event

Field	Type	Description
event_id	integer	Unique sub-event ID
event_main_id	integer	Points back to the main event
event_date	string	Date in YYYY-MM-DD
event_time	string	Start time HH:MM:SS
event_end	string	End time HH:MM:SS
event_view_end	string	Optional later-than-end cut-off (if used)
event_rep	string	sub for sub-events
event_free	integer	Maximum tickets per order (not actual capacity — see note)
event_status	string	pub for published, other values are internal
location_id	integer	Hall / location ID
location_name	string	Hall / location name

Notes on event_free

This field is deliberately censored in the public API: it returns the maximum number of tickets a user can put in their cart in one go, taking reserved offline capacity into account. It does not reveal real sales or remaining capacity.

For accurate capacity data (partner integrations only), use the Peppered endpoints.

Notes on event types

The event_type field may appear in authenticated endpoints — common values:

Type	Meaning
event	Regular performance
passepartout	Subscription / season pass
voucher	Gift voucher
combi	Combi-ticket (bundle of multiple events)
horeca	Date-bound product (food, drinks)
product	Merchandise

In the public endpoint only event types (sub-events) are returned in sub_events.

---

See also: Ticket types · Cart · Peppered events