The Recurring Events feature provides a linkage between recurrences of the same event:
Events that recur each year on the same day, such as Christmas Day.
Events that recur each year (or month, or other frequency) but change date and potentially location, such as the American Society of Haematology Annual Meeting.
As well as being able to see that an event is recurring, it’s also possible to find all recurrences of the same event.
Example Use Cases
Demand Forecasting: When analysing previous years transactions or bookings, you can align demand spikes with a recurring event and predict expected demand increases for future years.
Labour Optimization: Knowing why you were busy last year and planning your resource requirements for the same period next year. What if the event changes location? Recurring Events allows you to get this visibility and plan accordingly.
Recurring Events are represented as an Entity of type event-group with recurring info in iCalendar recurring RRULE format.
Below is an example event with a recurring event-group Entity:
{
"count": 1,
"results": [
{
"id": "3HieM5mavYqPikiHPw",
"title": "ASH Annual Meeting",
"category": "conferences",
"entities": [
{
"entity_id": "vAtN2UDcxySFtZFwLRvqcN",
"name": "ASH Annual Meeting",
"type": "event-group",
"category": "conferences",
"labels": [
"business",
"conference",
"event-group",
"expo",
"recurring"
],
"description": "The American Society of Hematology (ASH) Annual Meeting & Exposition provides an invaluable educational experience and the opportunity to review thousands of scientific abstracts highlighting updates in the hottest topics in hematology.",
"recurring": {
"ical": "DTSTART;VALUE=DATE:20141206\nDURATION:P4D\nRRULE:FREQ=YEARLY;INTERVAL=1"
}
}
],
...
}
]
}
Find all Instances of a Recurring Event
The entity.id query parameter allows you to find all Events that are linked to the specified Entity ID. This example uses the "ASH Annual Meeting" recurring event-group Entity ID to find all instances of the Event.
