With the upcoming shutdown of the Loxi calendar service on January 7, 2025, many users are looking for ways to preserve their event data and seamlessly transition to a new platform. Fortunately, exporting your Loxi events for migration to a different calendar solution is a straightforward process. In this article, we’ll guide you through the steps to export your events, ensuring you don’t lose any important dates or details during the move.
The exporting of events is done through REST API endpoints. If you don’t know what that means, no worries. This article will explain everything you need to know.
A REST API endpoint is like a specific address you visit on the web to get (or send) information. It's where an app or service goes to ask for data, like retrieving event details from a calendar, or to perform tasks, like adding or deleting events. Each address does something different depending on the task needed.
Loxi has three different endpoints, URLs available to retrieve your events.
Listing all events with their dates
This URL will show you all events in your calendar, along with their titles, time zones, and start and end dates.
https://mysite.loxi.io/api/loxi/v1/events/all
*make sure to change “mysite” to your Loxi calendar address.
This URL gives a JSON response and it is useful for looking up specific events and their ID, in case you would like to export a specific event.
You will likely NOT be able to export or migrate events with this URL. This is merely to allow you to identify your events.
Getting events with all their data
These URLs will retrieve all event details, so you can use them to export or migrate your events. It also provides some options to filter your events.
By default, you will be provided with a downloadable file containing the event data in the iCalendar format. iCalendar is an open standard for exchanging calendar information, and many calendar applications, such as Google Calendar, Outlook, or The Events Calendar, can use it to import events.
All future events
This URL will get you all future events from your calendar, with all their details.
https://mysite.loxi.io/api/loxi/v1/events
Events starting after a specific date
This can be helpful if you only want to export or migrate events starting after a specific date. For example, you might have events 2 years in the past, but you only want the ones that started on and after July 1, 2024. In that case, you can use the start_date parameter like this:
https://mysite.loxi.io/api/loxi/v1/events/?start_date=2024-07-01
Note, that the date needs to be in YYYY-MM-DD format.
If you would like to get all your events, then simply use a date far enough in the past, like 2010-01-01.
One specific event
If you would like to export a specific event, then first you need to look up its ID outlined at the beginning of this article. Once you have the ID - for example, 126 - you need to add it to the URL like this:
https://mysite.loxi.io/api/loxi/v1/event/126
(Notice the singular use of “event” in this URL.)
Other Useful Options
Pagination
If you have too many events in your calendar and would like to split them up into different files, or if the calendar you are importing to cannot digest all the information (times out during the process), you have the option to limit the number of events being exported with the post_per_page parameter.
To export only 20 events, you can do this:
https://mysite.loxi.io/api/loxi/v1/events/?post_per_page=20
This will give you the first 20 future events. To get the next batch, you can add the page parameter to the URL like this:
https://mysite.loxi.io/api/loxi/v1/events/?post_per_page=20&page=2
You can, of course, combine this with the date filtering. To get the second batch of 20 events that started after July 1, 2024:
https://mysite.loxi.io/api/loxi/v1/events/?start_date=2024-07-01&post_per_page=20&page=2
Output format
By default, when you use the /api/loxi/v1/events/ and /api/loxi/v1/event/ URLs, you will receive a downloadable iCalendar file. It is also possible to get the results printed on the screen in either the iCal format with the print parameter or JSON format with the json parameter.
To print the iCal format on the screen:
https://mysite.loxi.io/api/loxi/v1/events/print
To print the JSON format on the screen:
https://mysite.loxi.io/api/loxi/v1/events/json
(See screenshot in the “Getting all future events” section)
To print one event in iCal format:
https://mysite.loxi.io/api/loxi/v1/event/126/print
Again, it is possible to further combine these with the start_date and post_per_page parameters. As before, these will go at the end of the URL after a question mark, like:
https://mysite.loxi.io/api/loxi/v1/events/json/?start_date=2024-07-01
Migrating your events to The Events Calendar
If you have a website that runs The Events Calendar, you can use Event Aggregator to migrate your events from Loxi.
Here’s how to do that after you download the events from your Loxi calendar and save the ICS file to your PC.
- In your WordPress admin dashboard navigate to Events > Imports.
- From the “Import origin” dropdown list select “ICS File”.
- Browse and select the file you saved.
- Optional: If you want to import past events select the start date in the “Date” field.
- Click on the preview button to generate a preview list of the events that are going to be imported.
- Optionally, select the events you want imported. If you want to import all, you don’t need to select anything, just go to the next step.
- Click on the “Import All” (or “Import Checked”) button below the preview table.
This will start the import process, which can take some time depending on the amount of events that need to be imported.
If you get stuck or you need any assistance, our support team is here to help.