Endpoint - /events/{id}
Enkel evenement op
Calls
Endpoint | Beschrijving |
---|---|
get/events/{id} | Enkel evenement op |
get/events/{id}/deals | Specials bij een evenement op |
Voorbeeld response
{ "event": { "id": "24322", "parentid": "", "previousid": "", "url": "http://some.example.com/agenda-item/24322/Overnachten-in-Zwolle/", "img": "http://other.example.com/img/15122/70282-0.jpg", "title": "Overnachten in Zwolle", "subtitle": "En een ondertitel", "description": "Voor iedereen die een nachtje, weekend of langer in Zwolle wil verblijven zijn e...", "eventtype": "", "relevance": "20", "official_site": "http://example.com", "latlong": "", "lat": "", "long": "", "loc_title": "", "address": "", "zipcode": "", "city": "", "phone": "", "email": "foo@bar.nl", "website": "", "progam_website": "http://programma.nl", "sourcetag": "multimove::70282", "video": "", "canceled": "0", "html": "<!--B:TEXT-->\n<p>Zwolle ontdek je niet in \u00e9\u00e9n dag. Of je nu van wi...", "html_src": "Zwolle ontdek je niet in \u00e9\u00e9n dag. Of je nu van winkelen of uitgaan houdt, lief...", "from": "2026-12-17", "from_stamp": "1797462000", "from_timestamp": "2026-12-17 00:00:00", "until": "2026-12-17", "until_stamp": "1797462000", "until_timestamp": "2026-12-17 00:00:00", "tags": [ { "id": "53", "parentid": "0", "text": "Eigen parkeerplaats", "relevance": "15" }, { "id": "88", "parentid": "0", "text": "Fietsen & Wandelen", "relevance": "15" }, { "id": "21", "parentid": "0", "text": "Bereikbaar via trein", "relevance": "15" }, { "id": "2", "parentid": "0", "text": "Kunst & Cultuur", "relevance": "10" } ], "prices": [ { "id": "1000800024322", "event_id": "24322", "label_id": "8", "label": "Entreeprijs", "cents": "1000", "str": "\u20ac 10,00" }, { "id": "1002200024322", "event_id": "24322", "label_id": "22", "label": "Entreeprijs kinderen (t/m 12 jaar)", "cents": "500", "str": "\u20ac 5,00" } ], "children": [], "calendar_rules": [ { "id": "18585", "startdate": "2026-12-17", "enddate": "2026-12-17", "starttime": "00:00", "endtime": "23:59", "start_timestamp": "2026-12-17 00:00", "start_stamp": "1797462000", "end_timestamp": "2026-12-17 23:59", "end_stamp": "1797548340", "single": "1" }, { "id": "43064", "startdate": "2026-12-17", "enddate": "2026-12-19", "starttime": "10:00", "endtime": "17:00", "start_timestamp": "2026-12-17 10:00", "start_stamp": "1797498000", "end_timestamp": "2026-12-19 17:00", "end_stamp": "1797696000", "single": "", "textstring": "dagelijks", "mon": "*", "tue": "*", "wed": "*", "thu": "*", "fri": "*", "sat": "*", "sun": "*" } ], "gallery": [ { "id": "7513", "url": "http://other.example.com/img/7513/DSC_5980.jpg" }, { "id": "7516", "url": "http://other.example.com/img/7516/DSC_5993.jpg" }, { "id": "8865", "url": "http://other.example.com/img/8865/DSC_6000.jpg" }, { "id": "8885", "url": "http://other.example.com/img/8885/DSC_5985.jpg" }, { "id": "8889", "url": "http://other.example.com/img/8889/DSC_5987.jpg" }, { "id": "8890", "url": "http://other.example.com/img/8890/DSC_5986.jpg" }, { "id": "8895", "url": "http://other.example.com/img/8895/DSC_5979.jpg" } ], "location": { "abbr": "See the locations/{id} endpoint for details" }, "lastmodified": "2020-02-06T20:42:59+01:00", "lastmod_timestamp": "2020-02-06 20:42:59", "lastmod_stamp": "1581018179", "calendar": [ { "id": "185851797462000", "eventid": "24322", "startdate": "2026-12-17", "enddate": "2026-12-17", "starttime": "00:00", "endtime": "23:59", "start_timestamp": "2026-12-17 00:00", "start_stamp": "1797462000", "end_timestamp": "2026-12-17 23:59", "end_stamp": "1797548340", "title": "Overnachten in Zwolle", "subtitle": "En een ondertitel" }, { "id": "430641797498000", "eventid": "24322", "startdate": "2026-12-17", "enddate": "2026-12-17", "starttime": "10:00", "endtime": "17:00", "start_timestamp": "2026-12-17 10:00", "start_stamp": "1797498000", "end_timestamp": "2026-12-17 17:00", "end_stamp": "1797523200", "title": "Overnachten in Zwolle", "subtitle": "En een ondertitel" }, { "id": "430641797584400", "eventid": "24322", "startdate": "2026-12-18", "enddate": "2026-12-18", "starttime": "10:00", "endtime": "17:00", "start_timestamp": "2026-12-18 10:00", "start_stamp": "1797584400", "end_timestamp": "2026-12-18 17:00", "end_stamp": "1797609600", "title": "Overnachten in Zwolle", "subtitle": "En een ondertitel" }, { "id": "430641797670800", "eventid": "24322", "startdate": "2026-12-19", "enddate": "2026-12-19", "starttime": "10:00", "endtime": "17:00", "start_timestamp": "2026-12-19 10:00", "start_stamp": "1797670800", "end_timestamp": "2026-12-19 17:00", "end_stamp": "1797696000", "title": "Overnachten in Zwolle", "subtitle": "En een ondertitel" } ] } }
Details velden
- parentid
- Het ID van een bovenliggend evenement, als het onderdeel is van een groep evenementen. Er kan bijvoorbeeld een filmfestival zijn, onder de vleugels van dat festival kunnen vervolgens verschillende voorstellingen op verschillende plekken geprogrammeerd zijn. In het model is het dan zo dat deze losse evenementen het festival als parent hebben
- previousid
- Het ID van de vorige editie van een evenement (wanneer van toepassing)
- url
- Het webadres van het evenement in de huidige site
- title
- De titel van het evenement
- subtitle
- De ondertitel (vaak uitvoerend artiest)
- description
- Korte samenvatting of introductietekst
- eventtype
- Evenementtype, dit is een een van de volgende labels (of NULL)
- SPORT actief
- KIDS kinderen
- EDUCATION educatie
- WORKSHOP workshop
- TOUR rondleiding
- MOVIE film
- CONCERT muziek
- THEATRE theater
- EXPOSITION expositie
- SHOPPING winkelen
- MARKET markt
- FESTIVAL festival
- FOOD eten & drinken
- CULTURE kunst & cultuur
- relevance
- De allure van het evenement, 10 betekent lokaal, 20 regionaal, 30 landelijk en 40 duidt op een locatie van internationale allure
- official_site
- De website van de origanisator van het evenement
- latlong
- Een evenement kan gekoppeld zijn aan een locatie, in dat geval moet naar het coordinaat van de locatie worden gekeken. Als er geen gekoppelde locatie is staat hier (mogelijk) een coordinaat waar het evenement plaatsvindt
- loc_title
- Hier staat de naam van de locatie waar het evenement plaatsvindt staan (indien er geen gekoppelde locatie is)
- address
- Bevat het adres waar het evenement plaatsvindt staan (indien er geen gekoppelde locatie is)
- zipcode
- Bevat de postcode van het adres waar het evenement plaatsvindt staan (indien er geen gekoppelde locatie is)
- city
- De plaats waar het evenement plaatsvindt staan (indien er geen gekoppelde locatie is)
- phone
- Het adres waar het evenement plaatsvindt staan (indien er geen gekoppelde locatie is)
- E-mailadres van de locatie (indien er geen gekoppelde locatie is)
- website
- Website van de locatie (indien er geen gekoppelde locatie is)
- progam_website
- Externe website / document waar het programma van het evnement te vinden is
- sourcetag
- Code waaruit kan worden afgeleid wat de bron is van evenementen die zijn geïmporteerd uit externe systemen
- video
- Externe video gecodeerd in een uri in de vorm embed://{service}/{videoid}. Service kan zowel youtube als vimeo zijn
- canceled
- Boolean die aangeeft of een evenement is afgelast
- html
- Uitgebreide omschrijving van het evenement in HTML opmaak
- html_src
- Uitgebreide omschrijving van het evenement in Markdown opmaak
- from
- De beginddatum van het evenement in Y-m-d. De periode die wordt gemarkeerd met de from en until velden is de periode waarin het evenement plaatsvindt. Voor een eenmalig evenement zal dit één dag zijn. Maar evenementen kunnen vaker voorkomen. Om te kijken wanneer je naar het evenement toe kunt gaan moet gekeken worden naar de calendar_rules en/of calendar velden.
- from_stamp
- De beginddatum van het evenement als unix timestamp
- from_timestamp
- De beginddatum van het evenement als Y-m-d H:i:s
- until
- De einddatum van het evenement in Y-m-d
- until_stamp
- De einddatum van het evenement als unix timestamp
- until_timestamp
- De einddatum van het evenement als Y-m-d H:i:s
- prices
- Een array met objecten die de toegangsprijzen weergeven. Elk element heeft de volgende velden:
- price > eventid
- Id van het evenement
- price > label_id
- ID van het prijstype
- price > label
- Label van het prijstype
- price > cents
- De prijs in centen
- price > str
- De prijs opgemaakt als tekst, inclusief valuta en "gratis" in geval van een prijs van 0.
- children
- Een array van onderliggende evenementen, zie ook event > parentid
- calendar_rules
- Een array met kalenderregels. Uit deze regels kan worden afgeleid wanneer het evenement plaatsvindt. Elk element heeft de volgende velden:
- calendar_rule > eventid
- Id van de regel
- calendar_rule > startdate
- Datum vanaf wanneer de regel ingaat
- calendar_rule > enddate
- Datum tot en met wanneer de regel geldt
- calendar_rule > starttime
- (optioneel) aanvangstijd van het evenement
- calendar_rule > endtime
- (optioneel) eindtijd van het evenement
- calendar_rule > start_timestamp
- Start datum en aanvangstijd gecodeerd als tijdstip in Y-m-d H:i:s
- calendar_rule >start_stamp
- Start datum en aanvangstijd gecodeerd als tijdstip in unix epoch
- calendar_rule > end_timestamp
- Einddatum en eindtijd gecodeerd als tijdstip in Y-m-d H:i:s
- ecalendar_rule > nd_timestamp
- Einddatum en eindtijd gecodeerd als tijdstip in unix epoch
- calendar_rule > single
- Boolean die aangeeft of deze regel een eenmalig voorstelling / instance van het evenement is. Is deze boolean false, dan is er sprake van een terugkerend evenement op het gegeven tijdstip. In de velden mon - sun wordt verder beschreven op welke weekdagen de tijden gelden.
- calendar_rule > textstring
- Een tekstuele beschrijving van de regel
- calendar_rule > mon,tue,wed,thu,fri,sat,sun
- Elke dag van de week wordt beschreven met een code van 1 character. De volgende waarden komen voor, met hun betekenis:
- De tijden gelden niet op maandag in de periode
* De tijden gelden elke maandag in de periode
1 De tijden gelden elke eerste maandag in de periode
2 De tijden gelden elke tweede aandag in de periode
3 De tijden gelden elke derde maandag in de periode
4 De tijden gelden elke vierde maandag in de periode
5 De tijden gelden elke vijfde maandag in de periode
< De tijden gelden elke laatste maandag in de periode
- gallery
- Een array met extra beeldmateriaal bij het evenement. Elk element bevat een object met een image id en verwijzing naar de url van de foto
- location
- Als het evenement gekoppels is aan een locatie uit het systeem staan hier de details. Zie het endpoint locations/{id} voor de veldbeschrijving
- lastmodified
- Modification date in ISO 8601 formaat
- lastmod_timestamp
- Modification date in Y-m-d H:i:s
- lastmod_stamp
- Unix timestamp van de modification date
- calendar
- Een array met alle keren dat het evenement voorkomt op de kalender. Dit komt voort uit het toepassen van alle kalenderregels. Werk je met de calender_rules dan kun je de parameter
full=false meegeven. De kalenderitems worden dan niet doorgegeven waarmee data wordt bespaard. Elk element in de array heeft de volgende velden
- calendar_item > id
- Id van het itemt
- calendar_item > eventid
- Id van het event
- calendar_item > startdate
- Datum waarop het item begint
- calendar_item > enddate
- Datum waarop het item eindigt
- calendar_item > starttime
- Tijdstip waarop het item begint
- calendar_item > endtime
- Tijdstip waarop het item eindigt
- calendar_item > start_timestamp
- Datum en tijd waarop het item begint in Y-m-d H:i
- calendar_item > start_stamp
- Datum en tijd waarop het item begint als unix epoch
- calendar_item > end_timestamp
- Datum en tijd waarop het item eindigt in Y-m-d H:i
- calendar_item > end_stamp
- Datum en tijd waarop het item eindigt als unix epoch
- calendar_item > title
- Titel van het evenement
- calendar_item > subtitle
- Ondertitel van het evenement