imin Events API
The imin Events API enables developers to build real-time physical activity search into their applications. The API exposes a database of available physical activities, updated (often in real-time) from numerous activity providers.
The following pages offer guidance on using various parts of the Events API.
The maximum number of items that can be returned per page of results is 50 (
limit=50). This is to ensure our Platform can offer the best performance when returning results.
As a result of COVID-19, many leisure operators, when restrictions permit them to open their doors, will increase the number of swimming sessions and gym workouts available at their centres. Generally speaking, these take start every ten minutes (or fifteen minutes, etc.) to ensure a constant and regulated flow of people through the centres. Antithetically to this, the number of other activities, e.g. group exercise classes, reduce dramatically to comply with social distancing guidelines. The knock-on effect of this is a dramatic increase in the number of swimming and gym workout data available as open data, and a reduction in other activities.
In order to prevent the search results you receive from being overwhelmed by swimming and gym workout data, the Event API includes
iminTag[not]=HighFrequencySessionby default in every call. As a result of this, a general Events API search will return neither swimming nor gym workout sessions. However, if you want to the Events API to return all data, then you can override this default behaviour by included
showAllSessions=truein your API calls.