Get corporate activity audits

Fetch corporate activity audit trail

GET /corporate-activity/audits

Parameter	Type	DataType	Description
start_date	query	datetime	Fetch activity more recent than or equal to this date (default: -26 weeks)
end_date	query	datetime	Fetch activity older than or equal to 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 one or more bloomberg tickers (comma-separated)
isin	query	string	Filter to one or more ISINs (comma-separated)
cusip	query	string	Filter to one or more CUSIPs (comma-separated)
ric	query	string	Filter to one or more 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)

Request

https://premium.aiera.com/api/corporate-activity/audits?start_date=2024-10-03&end_date=2024-11-06&bloomberg_ticker=AMZN:US&size=2&include_activity=true

Response

{
  "params": {
    "start_date": "2024-10-03T00:00:00",
    "end_date": "2024-11-06T00:00:00",
    "bloomberg_ticker": "AMZN:US",
    "size": 2,
    "include_activity": true,
    "from_index": 0
  },
  "count": 2,
  "data": [
    {
      "corporate_activity_id": "8ce7f39c-8cfa-11ef-ae02-040106a3ab01",
      "change_date": "2024-10-17T22:42:01",
      "change_type": "create",
      "corporate_activity": {
        "corporate_activity_id": "8ce7f39c-8cfa-11ef-ae02-040106a3ab01",
        "title": "Amazon.com Inc Q3 Earnings 2024 - Conference Call",
        "type": "companymeeting",
        "subtype": "conferencecall",
        "when": "2024-10-31T17: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": 2646352,
          "event_title": "Q3 2024 Amazon.com Inc Earnings Call",
          "event_type": "earnings",
          "event_date": "2024-10-31T17:00:00",
          "has_unknown_time": false,
          "broadcast_url": "https://events.q4inc.com/attendee/878809675",
          "replay_url": "https://events.q4inc.com/attendee/878809675",
          "conference_number": null,
          "conference_pin": null,
          "slides_url": "https://a.aiera.com/api/events/2646352/assets/slides_url",
          "slides_url_type": "confirmed",
          "press_url": "https://a.aiera.com/api/events/2646352/assets/press_url",
          "press_url_type": "estimated",
          "transcription_status": "published",
          "transcription_audio_url": "https://audio.aiera.com/api/events/2646352/audio?api_key=API_KEY",
          "status": "active",
          "created": "2024-10-18T14:43:56",
          "modified": "2024-11-01T03:00:21"
        },
        "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": [],
        "metadata": {
          "contact": {
            "name": "Dave Fildes",
            "email": "amazon-ir@amazon.com",
            "telephone": "+1 206 266 2171"
          },
          "speakers": null,
          "webcasts": [
            {
              "url": "https://ir.aboutamazon.com/events/",
              "description": null
            }
          ],
          "regarding": null,
          "callDetails": {
            "dialInNumber": null
          },
          "localLanguage": false,
          "replayDetails": {
            "date": "2024-10-31T17:00:00.000Z",
            "timeZone": "America/New_York",
            "dialInEnds": "2024-10-31T00:00:00.000+00:00",
            "webcastUrl": "https://ir.aboutamazon.com/events/"
          },
          "preRegistration": false,
          "preRegistrationUrl": null
        },
        "explanation": "On October 31, 2024, Amazon.com Inc will hold their Q3 earnings conference call for the fiscal year. The event will be confirmed to take place in Seattle, US at 9:00 PM UTC. The conference call will be accessible via webcast, with details and a replay available at https://ir.aboutamazon.com/events/.",
        "created": "2024-10-17T22:42:01",
        "modified": null
      }
    },
    {
      "corporate_activity_id": "81a1d48a-8cfa-11ef-ae02-040106a3ab01",
      "change_date": "2024-10-17T22:41:42",
      "change_type": "create",
      "corporate_activity": {
        "corporate_activity_id": "81a1d48a-8cfa-11ef-ae02-040106a3ab01",
        "title": "Amazon.com Inc Q3 Earnings 2024",
        "type": "companyresults",
        "subtype": "earning",
        "when": "2024-10-31T16: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": 2646352,
          "event_title": "Q3 2024 Amazon.com Inc Earnings Call",
          "event_type": "earnings",
          "event_date": "2024-10-31T17:00:00",
          "has_unknown_time": false,
          "broadcast_url": "https://events.q4inc.com/attendee/878809675",
          "replay_url": "https://events.q4inc.com/attendee/878809675",
          "conference_number": null,
          "conference_pin": null,
          "slides_url": "https://a.aiera.com/api/events/2646352/assets/slides_url",
          "slides_url_type": "confirmed",
          "press_url": "https://a.aiera.com/api/events/2646352/assets/press_url",
          "press_url_type": "estimated",
          "transcription_status": "published",
          "transcription_audio_url": "https://audio.aiera.com/api/events/2646352/audio?api_key=API_KEY",
          "status": "active",
          "created": "2024-10-18T14:43:56",
          "modified": "2024-11-01T03:00:21"
        },
        "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": [
          "8ce7f39c-8cfa-11ef-ae02-040106a3ab01"
        ],
        "metadata": {
          "period": "quarter3",
          "fiscalYear": "2024-12-31",
          "marketStatus": "after"
        },
        "explanation": "On October 31, 2024, Amazon.com Inc will release their Q3 earnings for the fiscal year ending on December 31, 2024. The results will be announced after the market closes, and will take place in Seattle, Washington at 8:00 PM UTC.",
        "created": "2024-10-17T22:41:42",
        "modified": null
      }
    }
  ]
}

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