Find events

Fetch events by ticker, date range, etc.

GET /events-v2

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 (comma-separated)
start_date	query	datetime	Fetch events on or after this date (defaults to 2 weeks ago)
end_date	query	datetime	Fetch events on or before this date (defaults to 2 weeks from now)
equity_id	query	integer	Filter events to the equity ID provided
company_id	query	integer	Filter events to the company ID provided
bloomberg_ticker	query	string	Filter events to one or more bloomberg tickers (comma-separated)
isin	query	string	Filter events to one or more ISINs (comma-separated)
permid	query	string	Filter events to one or more PermIDs (comma-separated)
ric	query	string	Filter events to one or more Reuters/Refinitiv RICs (comma-separated)
ticker	query	string	Filter events to one or more tickers (comma-separated)
company_rollup	query	boolean	Whether to roll-up any matches to the corresponding company entity
sector_id	query	integer	Filter events to a specific sector ID
subsector_id	query	integer	Filter events to a specific subsector ID
event_ids	query	string	Filter events to one or more event IDs (comma-separated)
expected_language	query	string	Filter events to a specific expected language
with_transcripts	query	boolean	Whether to include only events with transcripts
with_pricing	query	boolean	Whether to include only events with pricing data
include_company_metadata	query	boolean	Whether to include the associated company's metadata (e.g. names, urls)
include_deleted	query	boolean	Whether to include deleted event records (for reconciliation)
include_connection_detail	query	boolean	Whether to include connection detail
include_hierarchy	query	boolean	Whether to include event hierarchy detail
include_estimated_docs	query	boolean	Whether to include model-estimated event docs
exclude_duplicates	query	boolean	Whether to exclude any duplicated events
linguistics	query	boolean	Whether to include linguistics metadata in the response
pricing	query	boolean	Whether to include price reaction information
simplified	query	boolean	Whether to simplify the payload response and avoid data enrichment
page	query	integer	The page of results to return
page_size	query	integer	The size of pages to return (default: 100, max: 2500)
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
Only one of the equity identifiers (bloomberg_ticker, isin, ric, permid, or ticker) should be used per request. Using multiple equity identifier query parameters will end up resolving only one of them.

Setting the simplified flag to true will significantly speed up query performance, but also nullify the following enriched fields:

has_unknown_time
connection_expected
is_live
machine_published
human_verified
slides_url
slides_url_type
press_url
press_url_type
public_url
public_share_url
live_asr_provider
transcription_audio_url
audio_offset_start
audio_offset_end
audio_stream_url
has_transcripts
has_api_transcript
has_pricing
connection_detail
event_tags
grouping
price_data
linguistics
company_metadata

Request

https://premium.aiera.com/api/events-v2?start_date=2024-11-06&end_date=2024-11-06&include_company_meta_data=true&linguistics=true&pricing=true

Response

{
  "params": {
    "start_date": "2024-11-06T00:00:00",
    "end_date": "2024-11-06T00:00:00",
    "linguistics": true,
    "pricing": true
  },
  "pagination": {
    "total_count": 1152,
    "current_page": 1,
    "total_pages": 112,
    "page_size": 100
  },
  "data": [
    {
      "event_id": 2640524,
      "company_id": 2612,
      "equity_id": 15331,
      "ticker": "DMP:AU",
      "local_ticker": "DMP",
      "bloomberg_ticker": "DMP:AU",
      "ric": "DMP.AX",
      "permid": "4295856495",
      "isin": "AU000000DMP0",
      "exchange_mic": "XASX",
      "sector_id": 1,
      "subsector_id": 25,
      "primary_equity": true,
      "title": "Domino's Pizza Enterprises Limited - Shareholder/Analyst Call",
      "event_type": "shareholder_meeting",
      "event_tags": [],
      "event_date": "2024-11-06T00:00:00-05:00",
      "expected_language": "en",
      "accuracy_review": "needs_review",
      "has_unknown_time": false,
      "connection_expected": true,
      "is_live": false,
      "machine_published": false,
      "machine_published_completed": null,
      "human_verified": false,
      "human_verified_completed": null,
      "connection_detail": {},
      "fiscal_year": null,
      "fiscal_quarter": null,
      "conference_number": null,
      "conference_pin": null,
      "broadcast_url": "https://meetings.linkgroup.com/agm/DMP24/register",
      "replay_url": null,
      "slides_url": "https://a.aiera.com/api/events/2640524/assets/press_url",
      "slides_url_type": "confirmed",
      "press_url": "https://a.aiera.com/api/events/2640524/assets/press_url?allow_estimated=true",
      "press_url_type": "estimated",
      "public_url": "https://dashboard.aiera.com/p/evtmin/e2ae5243e15ba3115ae81fba76d7351c",
      "public_share_url": "https://dashboard.aiera.com/p/DMP/event/11/06/2024/e2ae5243e15ba3115ae81fba76d7351c",
      "live_asr_provider": "backup",
      "transcription_status": "archived",
      "transcription_audio_url": "https://audio.aiera.com/api/events/2640524/audio?api_key=API_KEY",
      "transcription_audio_offset_seconds": 172,
      "audio_offset_start": 171709,
      "audio_offset_end": null,
      "audio_stream_url": "https://storage.media.aiera.com/2640524/00000192ffd5626b-5922c12c-9f671b7d8f0490fbd79cfb16e30b18d1/index.mpd",
      "has_transcripts": true,
      "has_api_transcript": true,
      "has_pricing": false,
      "duplicate_of": null,
      "corporate_activity_id": null,
      "hierarchy": {},
      "grouping": {
        "grouping_id": null,
        "grouping_name": null
      },
      "status": "active",
      "created": "2024-10-03T22:00:06-04:00",
      "modified": "2024-11-06T01:43:31-05:00",
      "linguistics": {
        "summaries": [
          {
            "title": "Leadership Transition and Financial Growth: Key Highlights from Domino's Pizza Enterprises Limited Shareholder Call",
            "summary": [
              "The Domino's Pizza Enterprises Limited Shareholder/Analyst Call covered several key topics. CEO Don Meij announced his retirement after 22 years, with Mark van Dyck appointed as the new CEO. The company reported FY2024 global sales increased 4.6% to $4.19 billion, with online sales up 7.5% to $3.37 billion. Underlying EBIT was $207.7 million. Australia/New Zealand earnings rose 10.4% to $124.1 million, while Europe's EBIT grew 26.6% to $70.7 million. However, Asian earnings declined $17.3 million due to challenges in Malaysia and Japan. The company maintained its long-term goal of 7,100 stores globally. Key focus areas include rebuilding value, strengthening franchisee partnerships, driving growth through customer value, and building a high-performance culture. The company faces ongoing challenges in Japan and France, with efforts underway to improve performance in those markets."
            ],
            "model": "zeroshot",
            "type": "everything",
            "version": "published",
            "audio_clip": null,
            "video_clip": null,
            "priority": 2,
            "created": "2024-11-06T01:42:34",
            "modified": null
          }
        ],
        "topics": [
          {
            "topic_id": 219686051,
            "topic": "AX ownership matters",
            "priority": 1,
            "events": null
          },
          {
            "topic_id": 25428,
            "topic": "Clothing",
            "priority": 2,
            "events": null
          },
          {
            "topic_id": 14289,
            "topic": "Compass Group",
            "priority": 3,
            "events": null
          },
          {
            "topic_id": 215498674,
            "topic": "Domino's Pizza Enterprises",
            "priority": 4,
            "events": null
          },
          {
            "topic_id": 219686053,
            "topic": "Faircase",
            "priority": 5,
            "events": null
          },
          {
            "topic_id": 190182,
            "topic": "Food Equipment",
            "priority": 6,
            "events": null
          },
          {
            "topic_id": 5739,
            "topic": "Global Sales",
            "priority": 7,
            "events": null
          },
          {
            "topic_id": 9264945,
            "topic": "Marketing Communications",
            "priority": 8,
            "events": null
          },
          {
            "topic_id": 12622,
            "topic": "Meals",
            "priority": 9,
            "events": null
          },
          {
            "topic_id": 97998791,
            "topic": "National Advertising Fund",
            "priority": 10,
            "events": null
          },
          {
            "topic_id": 96816345,
            "topic": "online sales",
            "priority": 11,
            "events": null
          },
          {
            "topic_id": 5088,
            "topic": "Pizza",
            "priority": 12,
            "events": null
          },
          {
            "topic_id": 24175,
            "topic": "Revel",
            "priority": 13,
            "events": null
          },
          {
            "topic_id": 219686052,
            "topic": "Teva Group",
            "priority": 14,
            "events": null
          },
          {
            "topic_id": 140803,
            "topic": "Uber",
            "priority": 15,
            "events": null
          }
        ],
        "auto_tags": [],
        "sentiment": {
          "average": 0.0,
          "median": 0.0,
          "minimum": 0.0,
          "maximum": 0.0
        }
      },
      "price_data": {},
      "transcripts": {},
      "company_metadata": null,
      "people": null
    }
  ]
}

Note that additional events would be returned, but only one is displayed above for length and readability

Code Samples

Bash

curl --request GET \
  --url 'https://premium.aiera.com/api/events' \
  --header 'X-API-Key: xxx'

Python

import requests
requests.request("GET", "https://premium.aiera.com/api/events", headers={"X-API-Key": "xxx"})