Pull Events from Your System

Expose a public API endpoint and we pull your events automatically into Festivalcadeau.

API Structure Requirements

To integrate with Festivalcadeau, your API must expose event data in a structured format. Below are the required fields and formats your API should support.

Event Model Specification

Your API must be able to provide event details with the following structure. If this cannot be done, please contact Festivalcadeau to find a suitable solution.

{
    "events": [
        {
            "event_id": "Unique Event Identifier",       // required
            "banner": "URL_to_event_banner_image",
            "poster": "URL_to_event_poster_image",
            "title": "Event Title",                       // required
            "description": "Event Description",
            "organiser": "Organiser's Name or ID",
            "date": "YYYY-MM-DD",                         // required (must be today or future)
            "time": "HH:MM",
            "end_date": "YYYY-MM-DD",
            "end_time": "HH:MM",
            "location": {                                 // required
                "streetname": "Street Name",
                "streetnumber": "Street Number",
                "zipcode": "Postal Code",
                "city": "City",
                "state": "State or Province",
                "country": "Country",
                "building": "Venue Building Name"
            },
            "minimum_age": 18,
            "genre": "Event Genre",
            "price": 50.00,
            "shopurl": "URL_to_ticket_purchase_page",
            "ticket_link": "Direct link to tickets",     // required
            "url": "Event Page URL",
            "video_link": "URL_to_event_video"
        }
    ]
}