iCal user calendar

Get an iCal formatted string for subscribing to Aiera's events calendar based on the user's watchlist(s)

GET /calendars/ical/user

Parameter	Type	DataType	Description
token	query	string	User's iCal token (required for authentication)
watchlist_id	query	integer	Specific watchlist ID to filter events (defaults to all user's watchlists)
types	query	string	Event types to include, comma-separated (default: all types)
excluded	query	string	Event types to exclude, comma-separated
end_date	query	string	End date for events: `1W`, `2W`, `4W`, `2M`, `3M` (default: 4 weeks)

NOTE

Date Range: Events from 2 weeks ago through the specified end date (default 4 weeks from now).
The token parameter is used for authentication instead of the standard API key header.

Request

https://premium.aiera.com/api/calendars/ical/user?token=YOUR_ICAL_TOKEN&end_date=2M

Response

Content-Type: text/calendar

Response Headers:

Content-Type: text/calendar
Cache-Control: max-age=3600

BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//Aiera//Event Calendar//EN
BEGIN:VEVENT
DTSTART:20241031T170000Z
DTEND:20241031T180000Z
SUMMARY:Amazon - Q3 2024 Amazon.com Inc Earnings Call
DESCRIPTION:Watch on Aiera: https://dashboard.aiera.com/...\nConference: ...\nBroadcast: ...
UID:event-2646352@aiera.com
END:VEVENT
END:VCALENDAR

iCal Event Fields

Event name: {company_name} - {event_title}
Event duration: 1 hour
Events with unknown times: Converted to all-day events with [Time TBD] suffix
Description includes: Aiera watch URL, conference number, conference pin, broadcast URL

Code Samples

Bash

curl --request GET \
  --url 'https://premium.aiera.com/api/calendars/ical/user?token=YOUR_ICAL_TOKEN'

Python

import requests
response = requests.get(
    "https://premium.aiera.com/api/calendars/ical/user",
    params={"token": "YOUR_ICAL_TOKEN"}
)
print(response.text)