Events

Events

GET https://api.voordemensen.nl/v1/:client_name/events/:event_id

List all or specific main- and subevents.

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	id of a specific main- or subevent OR use the string upcoming to filter on future events

200 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 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.