Create and maintain your database

Use the get events catalogue endpoint without the lastUpdatedAt parameter to retrieve all upcoming events.

You can’t get all the events at once. To retrieve all events, make multiple requests by incrementing the pageNumber parameter until it exceeds the total number of pages indicated in pagination.totalPages.

Store the event details found in data.events in your own database.

Make sure to save the event id returned for each event to identify them for future updates.

Set the lastUpdatedAt parameter to the timestamp of your last successful synchronisation.

This will retrieve all event details, including unchanged ones, for events that have been modified since your last sync.

You can choose to either completely replace the existing event information with the new data or update the fields individually by checking for changes.

You will also receive an array of event ids in eventIdsDeleted for events removed due to duplicates identified since your last sync. To keep your database up to date, delete the events matching these ids.