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"})