Back to top

Event - API reference

Lists upcoming events in Luxembourg.

Permissions

  • An API key is needed
  • Minimum 1 filter parameter is mandatory

Parameters

Name Description Variable name Possible values
Date Period of time date_from & date_to Dates in format YYYY-MM-DD
Category the event categories category One or several category IDs out of the category list (multiple values seperated by ",")
Venue the event venues venue One or several venue IDs out of the venue list (multiple values seperated by ",")
Audience the event audiences audience One or several audience IDs out of the audience list (multiple values seperated by ",")
Commune the event town communes commune One or several commune IDs out of the commune list (multiple values seperated by ",")
Tags the event keywords tags One or several keywords (entered by the event creator as keywords)
Page page number of results page Page number
First page = 0 (page=0)
Item per page number of results per page items_per_page 100,200,300,500 or 800

 

Fields

Name Description Variable name Possible values
ID ID of the event id (mandatory) Integer
Title name of the event title (mandatory) String
Subtitle subtitle of the event subtitle String
Pictures pictures of the event in several formats

pictures

  • original (max: 2000x2000px, scaled)
  • big (max: 650x650px, scaled)
  • thumb (400x300, cropped)
  • placeholder
  • copyright

 

  • String (URL)
  • String (URL)
  • String (URL)
  • Boolean
  • String
Event type type of the event event_type 1|Single or several dates
2|Regularly recurring event
3|Long or permanent event
Dates and timings
List
list of dates and timing of the event

dates_timing -> dates (multiple values possible, 1 mandatory)

  • from (mandatory)
  • to
Dates and timings in format
YYYY-MM-DD HH:MM:SS
Dates and timings Rrule repeating rule of an recurring event dates_timing -> rrule Rrule format

Dates and timings
Opening hours

Opening hours in case of a long or permanent event

dates_timing -> opening_hours

  • monday
    • from
    • to
  • tuesday
    • from
    • to
  • ...
String (ex. 20:00)
Dates and timings
Exeptionnally closed
Dates on whiich the long or permanent event is closed dates_timing -> exceptionnally_closed (multiple values) Dates in format
YYYY-MM-DD

Venues

list of venue IDs of the event

venues (multiple values)

  • id

Other fields are accessible in full feed type mode.
Specifications are available on the API reference venues page.

  • title
  • street
  • postcode : id, country_name, country_code,postcode,town
  • website
Integer
No fix location the event has no fix location no_fix_location Boolean
Prices entrance fees for the event

prices

  • title (ex. standard, reduced, cat 1)
  • value
String
Free of charge no entrance fees for the event freeofcharge Boolean
Description DE German event description description_de HTML text
Description FR French event description description_fr HTML text
Description EN English event description description_en HTML text
Description LU Luxembourgish event description description_lu HTML text
Categories event categories

categories (1 or 2 values, mandatory)

  • id
  • title_fr, title_de, title_en
  • integer
  • string
Audience event audience

audience

  • id
  • title_fr, title_de, title_en
  • integer
  • string
Tags keywords describing the event tags (multiple values separated by ",") string
Contact email Public contact or support email addresses contact_email (multiple values) email address
Contact phone number Public contact or support phone number contact_phonenumber string
Websites Websites of the event websites string (URL)
Online tickets Links to an online ticket shop

tickets_online (multiple values)

  • url
  • id
  • string (URL)
  • integer
Sales email address Sales email address for the event sales_email_address email address
Sales phone number Sales phone number for the event sales_phone_number string
Sales organisation Sales organisation for this event tickets_sold_by string
Sales website Link for more information sales_website string (URL)
Sales start date Ticket sales start date sales_start_date date format YYYY-MM-DD
Organizer Name of the organizer organizer string
Status Event status status string: scheduled, canceled or deleted

 

Examples

https://eventsinluxembourg.lu/fr/api/full/1.1/events?_format=json&commune=43945,43910&items_per_page=100&page=0&api-key=xxx

[ 
    { 
        "id":98390,
        "titre":"COMPUTER A KAFFI",
        "subtitle":"CAFÉ INFORMATIQUE",
        "pictures":[ 
            { 
                "original":"https://eventsinluxembourg.lu/sites/default/files/2019-04/203-Computer%20a%20Kaffi%20%285%29.jpg",
                "big":"https://eventsinluxembourg.lu/sites/default/files/styles/max_650x650/public/2019-04/203-Computer%20a%20Kaffi%20%285%29.jpg?itok=qEHwAh2z",
                "thumb":"https://eventsinluxembourg.lu/sites/default/files/styles/crop_thumbnail/public/2019-04/203-Computer%20a%20Kaffi%20%285%29.jpg?itok=e_UhO-e_",
                "agenda24":"https://eventsinluxembourg.lu/sites/default/files/styles/agenda24/public/2019-04/203-Computer%20a%20Kaffi%20%285%29.jpg?h=1467a2aa&itok=jgcPYJc-",
                "placeholder":false,
                "copyright":"4U CIGL"
            }
        ],
        "event_type":1,
        "dates_timing":[ 
            { 
                "dates":[ 
                    { 
                        "from":"2019-05-16 14:00:00",
                        "to":"2019-05-16 16:00:00"
                    },
                    { 
                        "from":"2019-06-13 14:00:00",
                        "to":"2019-06-13 16:00:00"
                    },
                    { 
                        "from":"2019-07-11 14:00:00",
                        "to":"2019-07-11 16:00:00"
                    },
                    { 
                        "from":"2019-09-19 14:00:00",
                        "to":"2019-09-19 16:00:00"
                    }
                ],
                "rrule":[ 
                    ""
                ],
                "opening_hours":[ 

                ],
                "exceptionally_closed_on":[ 

                ]
            }
        ],
        "venues":[ 
            { 
                "title":"4U - CIGL Esch",
                "id":32822,
                "street":"52-54 rue Pasteur",
                "postcode":[ 
                    { 
                        "id":41590,
                        "country":"Luxembourg",
                        "country_code":"LU",
                        "postcode":"L-4276",
                        "town_name":"ESCH-SUR-ALZETTE",
                        "commune":{ 
                            "id":"43910",
                            "name":"Esch-sur-Alzette"
                        }
                    }
                ],
                "websites":"",
                "geo_lng":5.975128,
                "geo_lat":49.492571
            }
        ],
        "no_fix_location":false,
        "prices":[ 

        ],
        "freeofcharge":true,
        "description_fr":"L’informatique est partout dans nos vies. Il nous permet de communiquer avec nos proches, nous divertir, nous informer, etc. Mais il n’est pas toujours évident de se retrouver dans ce monde numérique.<br />\r\nVenez poser toutes vos questions aux sympathiques formateurs et formatrices du CIGL, en toute convivialité",
        "description_en":"",
        "description_de":"Die Informatik ist inzwischen allgegenwärtig in unserem Leben und erlaubt uns, mit unseren Lieben zu kommunizieren, uns zu unterhalten oder zu informieren. Aber es ist nach wie vor nicht leicht, sich in der digitalen Welt zurechtzufinden.<br />\r\nStellen Sie Ihre Fragen während eines gemütlichen Zusammenseins an die sympathischen CIGL-Ausbilder / innen.  <br />\r\n ",
        "description_lu":"",
        "categories":[ 
            { 
                "id":24349,
                "title_fr":"Formation continue & conférences",
                "title_en":"Education & conferences",
                "title_de":"Weiterbildung & Konferenzen"
            }
        ],
        "audience":{ 
            "id":7,
            "title_fr":"Séniors",
            "title_en":"Seniors",
            "title_de":"Senioren"
        },
        "tags":"4U - CIGL Esch, Mosaïque Club - club senior à Esch-sur-Alzette, Kulturpass",
        "contact_email":[ 
            "mosaique-club@croix-rouge.lu"
        ],
        "contact_phonenumber":[ 
            "27 55 33 90"
        ],
        "websites":[ 
            "https://www.help.lu/fr/nos-services/clubs-senior"
        ],
        "tickets_sold_by":"",
        "sales_email_address":"",
        "sales_phone_number":"",
        "sales_website":"",
        "sales_start_date":"",
        "tickets_online":[ 

        ],
        "video":"",
        "organizer":"Mosaïque Club - club senior à Esch-sur-Alzette",
        "date_created":"2019-04-16 18:04:26",
        "date_updated":"2019-07-18 17:14:24",
        "status":"scheduled"
    },
    ...
]

https://eventsinluxembourg.lu/fr/api/light/1.1/events?_format=json&date_from=2019-12-24&date_to=2019-12-26&api-key=xxx

[ 
    { 
        "id":93012,
        "titre":"Tour in English",
        "subtitle":"",
        "pictures":[ 
            { 
                "original":"https://eventsinluxembourg.lu/sites/default/files/2018-12/Opening_JEFF_WALL_2018_02430_%C2%A9Marion_Dessard_Mudam_Luxembourg_2.jpg",
                "big":"https://eventsinluxembourg.lu/sites/default/files/styles/max_650x650/public/2018-12/Opening_JEFF_WALL_2018_02430_%C2%A9Marion_Dessard_Mudam_Luxembourg_2.jpg?itok=WSQtMoZ1",
                "thumb":"https://eventsinluxembourg.lu/sites/default/files/styles/crop_thumbnail/public/2018-12/Opening_JEFF_WALL_2018_02430_%C2%A9Marion_Dessard_Mudam_Luxembourg_2.jpg?itok=RH3-5zcz",
                "agenda24":"https://eventsinluxembourg.lu/sites/default/files/styles/agenda24/public/2018-12/Opening_JEFF_WALL_2018_02430_%C2%A9Marion_Dessard_Mudam_Luxembourg_2.jpg?h=b2a568f3&itok=6ufQvZLk",
                "placeholder":false,
                "copyright":"© Photo : Marion Dessard / Mudam Luxembourg"
            }
        ],
        "event_type":2,
        "dates_timing":[ 
            { 
                "dates":[ 
                    { 
                        "from":"2019-09-25 19:00:00"
                    },
                    { 
                        "from":"2019-10-02 19:00:00"
                    },
                    { 
                        "from":"2019-10-09 19:00:00"
                    },
                    { 
                        "from":"2019-10-16 19:00:00"
                    },
                    { 
                        "from":"2019-10-23 19:00:00"
                    },
                    { 
                        "from":"2019-10-30 19:00:00"
                    },
                    { 
                        "from":"2019-11-06 19:00:00"
                    },
                    { 
                        "from":"2019-11-13 19:00:00"
                    },
                    { 
                        "from":"2019-11-20 19:00:00"
                    },
                    { 
                        "from":"2019-11-27 19:00:00"
                    },
                    { 
                        "from":"2019-12-04 19:00:00"
                    },
                    { 
                        "from":"2019-12-11 19:00:00"
                    },
                    { 
                        "from":"2019-12-18 19:00:00"
                    },
                    { 
                        "from":"2019-12-25 19:00:00"
                    }
                ],
                "rrule":[ 
                    "RRULE:FREQ=WEEKLY;BYDAY=WE;UNTIL=20200101T000000Z"
                ],
                "opening_hours":[ 

                ],
                "exceptionally_closed_on":[ 

                ]
            }
        ],
        "venues":[ 
            "2245"
        ],
        "no_fix_location":false,
        "prices":[ 

        ],
        "freeofcharge":true,
        "description_fr":"",
        "description_en":"Guided tour of the exhibitions. For individual visitors and small groups. (max. 5 people)
\r\nTour free of charge, except for the entrance fee
\r\nNo booking required
\r\n
\r\nMudam Café
\r\nThese tours can be combined with brunch (weekend), lunch or an afternoon snack at Mudam Café. Booking recommended: t +352 45 37 85 970",
        "description_de":"",
        "description_lu":"",
        "categories":[ 
            "24347",
            "24355"
        ],
        "audience":5,
        "tags":"Mudam Luxembourg - Musée d'Art Moderne Grand Duc Jean, Kulturpass",
        "contact_email":[ 

        ],
        "contact_phonenumber":[ 

        ],
        "websites":[ 

        ],
        "tickets_sold_by":"",
        "sales_email_address":"",
        "sales_phone_number":"",
        "sales_website":"",
        "sales_start_date":"",
        "tickets_online":[ 

        ],
        "video":"",
        "organizer":"",
        "date_created":"2018-12-07 14:25:59",
        "date_updated":"2019-07-18 17:22:54",
        "status":"scheduled"
    },
    { 
        "id":99779,
        "titre":"Cabaret",
        "subtitle":" presented by Bill Kenwright%0ABook by Joe Masteroff / Music by John Kander / Lyrics by Fred Ebb%0ABased on the play by John Van Druten & Stories by Christopher Isherwood%0AEn anglais, avec surtitres en français & allemand 
",
        "pictures":[ 
            { 
                "original":"https://eventsinluxembourg.lu/sites/default/files/pictures/aa3d1480bb3b5bf2b5449b5bbf4f0f21.jpg",
                "big":"https://eventsinluxembourg.lu/sites/default/files/styles/max_650x650/public/pictures/aa3d1480bb3b5bf2b5449b5bbf4f0f21.jpg?itok=o93KVwio",
                "thumb":"https://eventsinluxembourg.lu/sites/default/files/styles/crop_thumbnail/public/pictures/aa3d1480bb3b5bf2b5449b5bbf4f0f21.jpg?itok=2ns2ruWm",
                "agenda24":"https://eventsinluxembourg.lu/sites/default/files/styles/agenda24/public/pictures/aa3d1480bb3b5bf2b5449b5bbf4f0f21.jpg?h=d32448e0&itok=CZnFHltw",
                "placeholder":false,
                "copyright":"(c) Pamela Raith Photography"
            }
        ],
        "event_type":1,
        "dates_timing":[ 
            { 
                "dates":[ 
                    { 
                        "from":"2019-12-26 20:00:00"
                    }
                ],
                "rrule":[ 
                    ""
                ],
                "opening_hours":[ 

                ],
                "exceptionally_closed_on":[ 

                ]
            }
        ],
        "venues":[ 
            "4142"
        ],
        "no_fix_location":false,
        "prices":[ 

        ],
        "freeofcharge":false,
        "description_fr":"%0A  Pas de saison au Grand Théâtre sans spectacle de fin d’année. À l’affiche cette fois:  Cabaret , une comédie musicale qui a triomphé non seulement sur les scènes de Broadway et du West End, mais qui, dans sa version cinématographique avec Liza Minnelli et Joel Grey, a notamment remporté 8 Oscars.%0A%0ABerlin, 1931. L’ère de la République de Weimar tire à sa fin et le parti nazi gagne en popularité. Cosmopolite, ouverte, insouciante, Berlin est alors une ville de divine décadence, à l’image du Kit Kat Club, le célèbre cabaret où se produit la légendaire Sally Bowles.%0A%0AChronique musicale sur fonds de passions amoureuses et de grands troubles politiques, Cabaret c’est aussi des chorégraphies à couper le souffle – d’autant plus qu’elles sont de Javier De Frutos, dont on n’a pas oublié l’ Eternal Damnation to Sancho and Sanchez  d’il y a quelques saisons –, des costumes éblouissants et des chansons emblématiques telles que  Willkommen, Money Makes The World Go Round, Maybe This Time, Cabaret  évidemment, le tout dans une mise en scène de Rufus Norris, directeur artistique du National Theatre de Londres.%0A%0ALa représentation du 31 décembre sera traditionnellement suivie du dîner de réveillon dans le foyer du Grand Théâtre.%0A%0A
%0ADirected by  Rufus Norris %0ADesigner  Katrina Lindsay Choreographer  Javier De Frutos %0ALighting Designer  Tim Oliver ,%0Abased on an original design by  Mark Howett %0ASound Designer  Dan Samson Cast a.o.  John Partridge, Kara Lily Hayworth, Anita Harris Lundi 23    DÉCEMBRE 2019  à 20  h00 (tickets)%0AJeudi 26    DÉCEMBRE 2019  à 20  h00 (tickets)%0AVendredi 27    DÉCEMBRE 2019  à 20  h00 (tickets)%0ASamedi 28    DÉCEMBRE 2019  à  15h00  (tickets)%0A& à 20h00 (tickets)%0ADimanche 29    DÉCEMBRE 2019  à 20  h00 (tickets)%0ALundi 30    DÉCEMBRE 2019  à 20  h00 (tickets)%0AMardi 31    DÉCEMBRE 2019  à  19h00  (tickets)%0AJeudi 2    JANVIER 2020  à 20  h00 (tickets)%0AVendredi 3    JANVIER 2020  à 20  h00 (tickets)%0ASamedi 4    JANVIER 2020  à    15h00  (tickets)%0A& à 20h00 (tickets)%0ADimanche 5    JANVIER 2020  à 20  h00 (tickets)    DURÉE  environ 2h15 & entracte%0A  Adultes 65 €, 40 €, 25 € / Jeunes 8 € / Kulturpass bienvenu Lieu: Grand Théâtre / Grande Salle %0A %0A%0A
",
        "description_en":"%0A  “Willkommen, Bienvenue, Welcome!” It has become a tradition for the Grand Théâtre to mark the end of the year with the presentation of a great spectacle. This time, Kander and Ebb’s landmark musical  Cabaret  will delight audiences over the festive season. This is a show that triumphed not only on Broadway and West End stages but, since its Broadway premiere and the movie version with Liza Minnelli and Joel Grey, has won numerous stage and screen awards including 8 Oscars, 7 BAFTAs and 13 Tonys.%0A%0A Cabaret  turns the Weimar Berlin of 1931 into a dark and sexually charged haven of decadence, at the heart of which the legendary Sally Bowles performs at the infamous Kit Kat Klub. Directed by Rufus Norris, Artistic Director of the National Theatre,  Cabaret  features show-stopping choreography by Olivier Award winner Javier De Frutos, dazzling costumes and some of the most iconic songs in musical theatre, including  Money Makes The World Go Round, Two Ladies, Maybe This Time  and, of course,  Cabaret .%0A%0AThe performance on New Year’s Eve will be followed by a sumptuous dinner party in the Grand Théâtre’s Foyer.%0A%0A » The most stunningly fresh and imaginative revival of a classic musical that I have ever seen. The Independent, Paul Taylor %0A%0A » A show stopper. Daily Mail, Quentin Letts %0A%0A » Overwhelming. Evening Standard, Nicholas de Jongh %0A
%0ADirected by  Rufus Norris %0ADesigner  Katrina Lindsay Choreographer  Javier De Frutos %0ALighting Designer  Tim Oliver ,%0Abased on an original design by  Mark Howett %0ASound Designer  Dan Samson Cast a.o.  John Partridge, Kara Lily Hayworth, Anita Harris Lundi 23    DÉCEMBRE 2019  à 20  h00 (tickets)%0AJeudi 26    DÉCEMBRE 2019  à 20  h00 (tickets)%0AVendredi 27    DÉCEMBRE 2019  à 20  h00 (tickets)%0ASamedi 28    DÉCEMBRE 2019  à  15h00  (tickets)%0A& à 20h00 (tickets)%0ADimanche 29    DÉCEMBRE 2019  à 20  h00 (tickets)%0ALundi 30    DÉCEMBRE 2019  à 20  h00 (tickets)%0AMardi 31    DÉCEMBRE 2019  à  19h00  (tickets)%0AJeudi 2    JANVIER 2020  à 20  h00 (tickets)%0AVendredi 3    JANVIER 2020  à 20  h00 (tickets)%0ASamedi 4    JANVIER 2020  à    15h00  (tickets)%0A& à 20h00 (tickets)%0ADimanche 5    JANVIER 2020  à 20  h00 (tickets)    DURÉE  environ 2h15 & entracte%0A  Adultes 65 €, 40 €, 25 € / Jeunes 8 € / Kulturpass bienvenu Lieu: Grand Théâtre / Grande Salle %0A %0A%0A
",
        "description_de":"%0A  Keine Spielzeit des Grand Théâtre ist komplett ohne ein großes Finale zum Jahresende. Diesmal auf dem Programm:  Cabaret , ein Musical, das nicht nur auf Broadway- und West End-Bühnen triumphierte, sondern auch in seiner Kinoversion mit Liza Minnelli und Joel Grey 8 Oscars gewann.%0A%0AWir schreiben das Jahr 1931 in Berlin, einer Stadt der göttlichen Dekadenz, am Vorabend der Nazi-Herrschaft. Im Kit Kat Club, dem berühmten Kabarett, tritt die legendäre Sally Bowles auf. Vor der Kulisse dieser verruchten Nachtbar tauchen wir ein in eine Welt zwischen Glanz und Abgrund, Traum und Trauma, und begeben uns an einen Ort der geschichtlichen Brüche.%0A%0AEingebettet in das flirrende Nachtleben der Weimarer Republik vereint Cabaret auf ideale Weise eine packende Geschichte, raffinierte Songs wie  Willkommen, Money Makes The World Go Round, Maybe This Time  und  Cabaret , atemberaubende Kostüme und eine überwältigende Choreographie von Javier De Frutos, dessen  Eternal Damnation to Sancho and Sanchez  dem Publikum noch in Erinnerung ist – alles unter der Regie von Rufus Norris, dem künstlerischen Leiter des National Theatre in London.%0A%0AAm 31. Dezember findet nach der Vorstellung das traditionelle Silvesteressen im Foyer des Theaters statt.%0A
%0ADirected by  Rufus Norris %0ADesigner  Katrina Lindsay Choreographer  Javier De Frutos %0ALighting Designer  Tim Oliver ,%0Abased on an original design by  Mark Howett %0ASound Designer  Dan Samson Cast a.o.  John Partridge, Kara Lily Hayworth, Anita Harris Lundi 23    DÉCEMBRE 2019  à 20  h00 (tickets)%0AJeudi 26    DÉCEMBRE 2019  à 20  h00 (tickets)%0AVendredi 27    DÉCEMBRE 2019  à 20  h00 (tickets)%0ASamedi 28    DÉCEMBRE 2019  à  15h00  (tickets)%0A& à 20h00 (tickets)%0ADimanche 29    DÉCEMBRE 2019  à 20  h00 (tickets)%0ALundi 30    DÉCEMBRE 2019  à 20  h00 (tickets)%0AMardi 31    DÉCEMBRE 2019  à  19h00  (tickets)%0AJeudi 2    JANVIER 2020  à 20  h00 (tickets)%0AVendredi 3    JANVIER 2020  à 20  h00 (tickets)%0ASamedi 4    JANVIER 2020  à    15h00  (tickets)%0A& à 20h00 (tickets)%0ADimanche 5    JANVIER 2020  à 20  h00 (tickets)    DURÉE  environ 2h15 & entracte%0A  Adultes 65 €, 40 €, 25 € / Jeunes 8 € / Kulturpass bienvenu Lieu: Grand Théâtre / Grande Salle %0A %0A%0A
",
        "description_lu":"",
        "categories":[ 
            "24342"
        ],
        "audience":6,
        "tags":"theater.lu, vdl.lu, Grand Théâtre de la Ville de Luxembourg",
        "contact_email":[ 

        ],
        "contact_phonenumber":[ 

        ],
        "websites":[ 
            "http://www.theatres.lu/-p-20004220.html"
        ],
        "tickets_sold_by":"",
        "sales_email_address":"",
        "sales_phone_number":"",
        "sales_website":"",
        "sales_start_date":"",
        "tickets_online":[ 
            { 
                "id":"27382",
                "link":"http://tickets.luxembourg-ticket.lu/27382",
                "date":"2019-12-26 20:00:00"
            }
        ],
        "video":"",
        "organizer":"",
        "date_created":"2019-05-21 12:53:24",
        "date_updated":"2019-09-19 10:00:02",
        "status":"scheduled"
    }
]