Calendar
Get calendar
Fetch calendar information by a specific equity(s) or watchlist(s)
GET /calendar/
Parameter | Type | DataType | Description |
---|---|---|---|
modified_since | query | datetime | Returns events modified since this date |
event_type | query | string | Filter by: earnings, earnings_release, presentation, investor_meeting, special_situation |
start_date | query | datetime | Fetch events ≥ this date (default: -2 weeks) |
end_date | query | datetime | Fetch events ≤ this date (default: +2 weeks) |
bloomberg_ticker | query | string | Filter events to 1+ Bloomberg tickers (comma-separated) |
isin | query | string | Filter events to 1+ ISINs (comma-separated) |
permid | query | string | Filter to one or more PermID identifiers (comma-separated) |
ric | query | string | Filter events to 1+ Reuters/Refinitiv RICs (comma-separated) |
ticker | query | string | Filter events to 1+ local tickers (comma-separated) |
watchlist_id | query | integer | Filter to one or more watchlist IDs (comma-separated) |
include_deleted | query | boolean | Whether to include deleted event records (for reconciliation) |
include_private | query | boolean | Whether to include private events |
from_index | query | integer | The index from which to start returning results |
size | query | integer | The number of events to return (max: 1,000) |
sort_key | query | string | Sort by event_id_asc, event_id_desc, event_date_asc (default), and event_date_desc |
NOTE
- modified_since can be used to synchronize with an external system.
- All dates (event_date, created, modified) are in Eastern Time (America/New_York timezone) and formatted in ISO 8601.
- By default, start_date and end_date are set to +/- 2 weeks.
- Only one of the equity identifiers (bloomberg_ticker, isin, permid, ric, or ticker) should be used per request. Using multiple equity identifier query parameters will end up resolving only one of them.
- You can only pull a maximum of 365 days worth of calendar data at a time (using start_date and end_date, or modified_since). You could extend this range to 730 days by filtering to specific equities using one of the supported identifiers (or the watchlist_id parameter).
Response
{
"params": {
"start_date": "2023-01-01T00:00:00",
"end_date": "2023-02-03T14:38:01.289052",
"bloomberg_ticker": "AMZN:US",
"size": 100,
"from_index": 0
},
"count": 1,
"events": [
{
"event_id": 2341068,
"event_title": "Q4 2022 Amazon.com Earnings Call",
"event_type": "earnings",
"event_date": "2023-02-02T17:30:00",
"equity": {
"equity_id": 1,
"local_ticker": "AMZN",
"bloomberg_ticker": "AMZN:US",
"ric": "AMZN.OQ",
"permid": "4295905494",
"isin": "US0231351067",
"exchange_mic": "XNAS"
},
"corporate_activity_id": "15ef0fb4-1c71-11ee-a724-040106a3ab01",
"has_unknown_time": false,
"connection_expected": true,
"broadcast_url": "https://events.q4inc.com/attendee/349811217",
"replay_url": "https://events.q4inc.com/attendee/349811217",
"conference_number": null,
"conference_pin": null,
"slides_url": "https://a.aiera.com/api/events/2341068/assets/slides_url",
"press_url": "https://a.aiera.com/api/events/2341068/assets/press_url",
"transcription_status": "published",
"transcription_audio_url": "https://audio.aiera.com/api/events/2341068/audio",
"status": "active",
"created": "2023-01-20T02:12:46",
"modified": "2023-02-03T03:04:44"
}
]
}
Code Samples
Bash
curl --request GET \
--url 'https://premium.aiera.com/api/calendar/' \
--header 'X-API-Key: xxx'
Python
import requests
requests.request("GET", "https://premium.aiera.com/api/calendar/", headers={"X-API-Key": "xxx"})