Events

get
Events

https://api.voordemensen.nl/v1/:client_name/events/:event_id
List all or specific main- and subevents.
Request
Response
Request
Path Parameters
client_name
required
string
the short name identifying you as a VdM client e.g. demo or fringe
event_id
optional
string
id of a specific main- or subevent OR use the string upcoming to filter on future events
Response
200: OK
Events successfully retrieved
[
{
"event_id": 94,
"event_name": "VoordeMensen Demo Event",
"event_text": "Extra tekst",
"event_short_text": "Subtitel of naam van het gezelschap",
"event_image": null,
"sub_events": [
{
"event_id": 95,
"event_name": "VoordeMensen Demo Event",
"event_text": "Extra tekst",
"event_short_text": "Subtitel of naam van het gezelschap",
"event_url": null,
"event_image": null,
"event_date": "2022-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"
},
{
"event_id": 96,
"event_name": "VoordeMensen Demo Event",
"event_text": "Extra tekst",
"event_short_text": "Subtitel of naam van het gezelschap",
"event_url": null,
"event_image": null,
"event_date": "2022-04-02",
"event_time": "15:00:00",
"event_end": "17:00: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"
},
{
"event_id": 97,
"event_name": "VoordeMensen Demo Event",
"event_text": "Extra tekst",
"event_short_text": "Subtitel of naam van het gezelschap",
"event_url": null,
"event_image": null,
"event_date": "2022-04-02",
"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 was not found
{ "message": "Event not found"}

Events in the response are grouped by main_event and sub_events. In VdM every event has a main_event and at least one sub_event. This allows for different performances of the same show to be grouped.

Note that the field event_free for free seats is censored in the public facing API's: it will show the maximum available tickets per order (or less, if less are available) and reveals nothing about actual capacity/sales.