Corporate Activity
Get corporate activity audits
Fetch corporate activity audit trail
GET /corporate-activity/audits
Parameter | Type | DataType | Description |
---|---|---|---|
start_date | query | datetime | Fetch activity ≥ this date (default: -26 weeks) |
end_date | query | datetime | Fetch activity ≤ this date (default: +26 weeks) |
modified_since | query | datetime | Returns activity modified since this date |
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 full corporate activity object |
NOTE
- Only one of the equity identifiers (bloomberg_ticker, isin, cusip, ric, or ticker) should be used per request. Using multiple equity identifier query parameters will end up resolving only one of them.
- Only use either start_date and end_date, or modified_since, but not both
- You can only pull a maximum of 3 days worth of audit data at a time (using start_date and end_date, or modified_since)
Response
{
"params": {
"start_date": "2023-10-17T22:40:43.836039",
"end_date": "2024-01-15T22:40:43.836087",
"size": 100,
"from_index": 0
},
"count": 1827123,
"data": [
{
"corporate_activity_id": "ea08094c-8498-11ee-96d9-040106a3ab01",
"change_date": "2023-11-16T10:57:59",
"change_type": "create",
"corporate_activity": {
"title": "Rockwool International Q3 Results 2023 - Conference Call",
"type": "companymeeting",
"subtype": "conferencecall",
"when": "2023-11-23T05:00:00",
"date_is_exact": true,
"is_tentative": false,
"is_estimated": false,
"is_postponed": false,
"is_cancelled": false,
"raw_identifiers": {
"isin": "DK0010219153",
"cusip": null,
"company_name": "Rockwool International",
"delisted": false
},
"event": null,
"equity": {
"equity_id": 21030,
"company_id": 3108,
"company_name": "Rockwool Intl",
"local_ticker": "ROCK B",
"bloomberg_ticker": "ROCKB:DC",
"ric": "ROCKb.CO",
"permid": "4295865965",
"isin": "DK0010219153",
"cusip": null,
"exchange_mic": "XCSE"
},
"related_ids": [],
"metadata": {
"contact": {
"name": "Thomas Harder",
"email": "investor@rockwool.com",
"telephone": "+45 4655 8677"
},
"speakers": [
"Jens Birgersson, CEO",
"Kim Junge Andersen, CFO"
],
"webcasts": {
"webcast": {
"url": "https://www.rockwool.com/group/about-us/investors/",
"description": null
}
},
"replayDetails": {
"date": "2023-11-23T11:00:00.000Z",
"timeZone": "Europe/Copenhagen",
"dialInEnds": "2023-11-22T00:00:00.000+00:00"
}
},
"explanation": "On November 23, 2023, Rockwool International will hold a conference call and webcast to discuss their Q3 results for the fiscal year ending on September 30, 2023. The call will take place at 10:00 AM UTC and will feature speakers Jens Birgersson, CEO, and Kim Junge Andersen, CFO. The call will be accessible via webcast at https://www.rockwool.com/group/about-us/investors/.",
"created": "2022-12-05T10:30:24.450Z",
"modified": "2023-11-15T06:55:44.007Z"
}
},
{
"corporate_activity_id": "bc58a33c-877b-11ed-ba87-040106a3ab01",
"change_date": "2023-11-16T10:46:43",
"change_type": "update",
"changes": {
"start_date": {
"prior": "2023-11-17 10:50:00.000000000 Z",
"adjusted": "2023-11-17 11:50:00.000000000 Z"
}, ...
},
"corporate_activity": {
"corporate_activity_id": "bc58a33c-877b-11ed-ba87-040106a3ab01",
"title": "Strategic Investments Q3 Results 2023",
"type": "companyresults",
"subtype": "result",
"when": "2023-11-17T06:50:00",
"date_is_exact": true,
"is_tentative": false,
"is_estimated": false,
"is_postponed": false,
"is_cancelled": false,
"raw_identifiers": {
"isin": "DK0010271238",
"cusip": null,
"company_name": "Strategic Investments",
"delisted": false
},
"event": null,
"equity": null,
"related_ids": [],
"metadata": {
"period": "quarter3",
"fiscalYear": "2023-12-31",
"marketStatus": "during"
},
"explanation": "On November 17, 2023, Strategic Investments will release their Q3 results for the fiscal year ending on December 31, 2023. The results will be announced during market hours, and will take place in Copenhagen, Denmark at 10:20 AM UTC.",
"created": "2022-12-05T10:30:24.450Z",
"modified": "2023-11-15T06:55:44.007Z"
}
}, ...
], ...
}
Code Samples
Bash
curl --request GET \
--url 'https://premium.aiera.com/api/corporate-activity/audits' \
--header 'X-API-Key: xxx'
Python
import requests
requests.request("GET", "https://premium.aiera.com/api/corporate-activity/audits", headers={"X-API-Key": "xxx"})