Event - Docs

The data dictionary and definitions for Events

Fields

Parameter	Type	Description
event_id	int	The Aiera-unique identifier for the event
company_id	int	The Aiera-unique identifier for the associated company
equity_id	int	The Aiera-unique identifier for the associated equity
ticker	str	The ticker on the local exchange for the associated equity
local_ticker	str	The ticker on the local exchange for the associated equity
bloomberg_ticker	str	The Bloomberg identifier for the associated equity
ric	str	The RIC for the associated equity
permid	str	The PermID for the associated equity
isin	str	The ISIN for the associated equity
exchange_mic	str	The Exchange market identifier code (MIC) for the associated equity
primary_equity	bool	Whether the equity is primary for the Aiera-unique company
title	str	The title of the event
event_type *	str	The type of the event
event_date	datetime	The date and time of the event
has_unknown_time	bool	Whether the event time is not yet certainly known
connection_expected	bool	Whether we currently expect to connect live to this event
is_live	bool	Whether we are currently connected to the live event
machine_published	bool	Whether the post-live machine rebuild of the transcript is complete
machine_published_completed	datetime	Timestamp when the post-live machine rebuild completed
human_verified	bool	Whether there is a human edited/verified transcript available
human_verified_api	bool	Whether there is a human edited/verified transcript available by API
human_verified_version	int	The version number for any human edited/verified transcript, if available
human_verified_source	str	Where a human edited/verified transcript was sourced, if available
human_verified_source_id	str	Third-party identifier for human edited/verified transcript, if available
fiscal_year	int	If event_type is earnings, what fiscal year is relevant
fiscal_quarter	int	If event_type is earnings, what fiscal quarter is relevant
conference_number	str	The dial-in number for this event, if any
broadcast_url	str	The webcast URL of this event, if any
replay_url	str	The replay webcast URL of this event, if any
slides_url	str	The slide presentation URL for this event, if any
slides_url_type	str	Whether the slides URL is confirmed or estimated
press_url	str	The press release URL for this event, if any
press_url_type	str	Whether the press_url is confirmed or estimated
public_url	str	The publicly-accessible URL for this event
public_share_url	str	The publicly-accessible URL for this event with additional features
transcription_status *	str	The status of our live transcription
transcription_audio_url	str	The URL of the final audio file for this event, if available
transcription_audio_offset_seconds	int	The offset from the raw file for the start of the transcript
audio_stream_url	str	The live HLS stream URL for this event, if available
has_transcripts	bool	Whether this event currently has an available transcript
has_api_transcript	bool	Whether the event transcript is available in this REST API
has_pricing	bool	Whether this event currently has pricing information
grouping *	obj	JSON object for metadata around event grouping, such as conference
status	str	The current status of this event [active or deleted]
created	datetime	When this event object was first created in Aiera systems
modified	datetime	When this event was last edited in Aiera systems
linguistics *	obj	JSON object composed of linguistic-extractions, like summaries, etc.
transcripts	list	A list of transcripts
company_metadata *	obj	JSON object composed of company metadata, like names, urls, etc.

Possibles

event_type

Option	Description
earnings	A quarterly or annual earnings call
earnings_release	The expected release date of earnings information
presentation	A conference or other special presentation
shareholder_meeting	A known (public or otherwise) shareholder-only meeting
investor_meeting	A known (public or otherwise) investor specific meeting
special_situation	An unusual or non-recurring event, like M&A
custom	A user-generated event (visible only to user and org members

transcription_status

Option	Description
submitted	Event is queue'd up and waiting
agent_connected	Initial connection has been established
connected	Audio connection has been established and awaiting transcription
started	Audio and transcription are ongoing
finished	The event has concluded and is awaiting post-processing
archived	The event has been post-processed and is complete
missed	The event, unfortunately, failed to properly connect

company url_type

Option	Description
filings	URL for company filings
home	URL for company's homepage
ir_events	URL for company's investor relation events
ir_home	URL for company's investor relations homepage
ir_news	URL for company's investor relation news
logo_icon	URL for company's logo image
youtube	URL for company's official YouTube page

summary_type

Option	Description
zeroshot	Free-form AI summarization that captures main themes and insights in a narrative style
constrained	Structured AI summarization focused on key metrics, facts, and guidance with specific formatting
bullets	Concise bullet-point format highlighting key takeaways (requires review before display)
criticals	Focused summarization of critical announcements, changes, and material information

grouping

{
    "grouping_id": INT,
    "grouping_name": STR
}

linguistics

{
  "summaries": [
    {
      "title": SUMMARY TITLE,
      "summary": [
        SUMMARY PARAGRAPHS
      ],
      "model": (zeroshot|bullet),
      "type": SUMMARY TYPE (presentation|q_and_a|everything),
      "audio_clip": AUDIO CLIP URL,
      "video_clip": VIDEO CLIP URL,
      "priority": SUMMARY PRIORITY ORDERING,
      "created": SUMMARY CREATION DATE,
      "modified": LAST SUMMARY MODIFICATION DATE
    }, ...
  ],
  "topics": [
    {
      "topic_id": AIERA-UNIQUE TOPIC ID,
      "topic": TOPIC,
      "priority": PRIORITY ORDERING
    }, ...
  ],
  "auto_tags": [
    TAG, ...
  ],
  "sentiment": {
    "average": AVERAGE SENTIMENT SCORE (-1 to 1),
    "median": MEDIAN SENTIMENT SCORE (-1 to 1),
    "minimum": MINIMUM DETECTED SEGMENT SCORE,
    "maximum": MAXIMUM DETECTED SEGMENT SCORE
  }
}

company_metadata

{
  "company_metadata": {
    "company_id": 1,
    "common_name": "Amazon",
    "legal_name": "Amazon.com Inc",
    "incorporated_country_code": "US",
    "domiciled_country_code": "US",
    "urls": [
      {
        "url": "https://s3.amazonaws.com/assets.aiera.com/assets/manual-override-1-1723048553.9238625.png",
        "url_type": "logo_icon"
      },
      {
        "url": "https://ir.aboutamazon.com/overview/default.aspx",
        "url_type": "ir_home"
      },
      {
        "url": "https://ir.aboutamazon.com/events/default.aspx",
        "url_type": "ir_events"
      },
      {
        "url": "https://press.aboutamazon.com/press-release-archive",
        "url_type": "ir_news"
      },
      {
        "url": "https://www.amazon.com/",
        "url_type": "home"
      },
      {
        "url": "https://ir.aboutamazon.com/sec-filings/default.aspx",
        "url_type": "filings"
      },
      {
        "url": "https://www.youtube.com/user/amazon",
        "url_type": "youtube"
      }
    ]
  }
}