Corporate Activity
Find corporate activity
Fetch corporate activity information by a specific equity(s) or watchlist(s)
GET /corporate-activity
Parameter | Type | DataType | Description |
---|---|---|---|
start_date | query | datetime | Fetch activity ≥ this date (default: -4 weeks) |
end_date | query | datetime | Fetch activity ≤ this date (default: +4 weeks) |
activity_type | query | string | Filter to a specific type |
activity_subtype | query | string | Filter to a specific subtype |
bloomberg_ticker | query | string | Filter to 1+ bloomberg tickers (comma-separated) |
isin | query | string | Filter to 1+ ISINs (comma-separated) |
cusip | query | string | Filter to 1+ CUSIPs (comma-separated) |
ric | query | string | Filter to 1+ Reuters/Refinitiv RICs (comma-separated) |
permid | query | string | Filter to one or more PermID identifiers (comma-separated) |
watchlist_id | query | integer | Filter to one or more watchlist IDs (comma-separated) |
from_index | query | integer | The index from which to start returning results |
size | query | integer | The number of events to return (max: 1,000) |
include_activity | query | boolean | Whether to include the current corporate activity details |
NOTE
- All dates are shown in Eastern Time (America/New_York timezone) and formatted in ISO 8601, unless otherwise noted
- By default, start_date and end_date are set to +/- 4 weeks
- Only one of the equity identifiers (bloomberg_ticker, isin, cusip, ric, or permid) 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 90 days of corporate activity data at a time (using start_date and end_date)
Response
{
"params": {
"start_date": "2023-01-01T18:14:59.234734",
"end_date": "2023-12-31T18:14:59.234809",
"ticker": "AMZN",
"size": 100,
"from_index": 0
},
"count": 6,
"data": [
{
"corporate_activity_id": "475be7a0-6e0a-11e7-93b8-040106a3ab01",
"title": "Amazon.com Inc Q3 Earnings 2017",
"type": "companyresults",
"subtype": "earning",
"when": "2017-10-26T16:00:00",
"date_is_exact": true,
"is_tentative": false,
"is_estimated": false,
"is_postponed": false,
"is_cancelled": false,
"raw_identifiers": {
"isin": null,
"cusip": "023135106",
"company_name": "Amazon.com Inc",
"delisted": false
},
"event": {
"event_id": 5227,
"event_title": "Q3 2017 Earnings Call",
"event_type": "earnings",
"event_date": "2017-10-26T17:30:00",
"has_unknown_time": false,
"broadcast_url": "https://edge.media-server.com/m6/p/p76hfxvg",
"replay_url": "https://edge.media-server.com/m6/p/p76hfxvg",
"conference_number": null,
"conference_pin": null,
"slides_url": "https://a.aiera.com/api/events/5227/assets/slides_url",
"press_url": "https://a.aiera.com/api/events/5227/assets/press_url",
"transcription_status": "published",
"transcription_audio_url": null,
"status": "active",
"created": "2019-07-25T16:48:19",
"modified": "2023-09-17T10:40:42"
},
"equity": {
"equity_id": 1,
"company_id": 1,
"company_name": "Amazon",
"local_ticker": "AMZN",
"bloomberg_ticker": "AMZN:US",
"ric": "AMZN.OQ",
"permid": "4295905494",
"isin": "US0231351067",
"cusip": "023135106",
"exchange_mic": "XNAS"
},
"related_ids": [
"9629291a-7c63-11ee-96d9-040106a3ab01"
],
"metadata": {
"period": "quarter3",
"fiscalYear": "2017-12-31",
"marketStatus": "after"
},
"explanation": "On October 26, 2017, Amazon.com Inc will release their Q3 earnings for the fiscal year ending on December 31, 2017. The results will be announced after the market closes, and will take place in Seattle, WA at 8:00 PM UTC.",
"created": "2023-11-06T05:15:47.995Z",
"modified": "2023-11-06T05:16:06.894Z"
}, ...
]
}
Code Samples
Bash
curl --request GET \
--url 'https://premium.aiera.com/api/corporate-activity/' \
--header 'X-API-Key: xxx'
Python
import requests
requests.request("GET", "https://premium.aiera.com/api/corporate-activity/", headers={"X-API-Key": "xxx"})