Dictionary

Event

The data dictionary and definitions for Events


Fields

ParameterTypeDescription
event_idintThe Aiera-unique identifier for the event
company_idintThe Aiera-unique identifier for the associated company
equity_idintThe Aiera-unique identifier for the associated equity
tickerstrThe ticker on the local exchange for the associated equity
local_tickerstrThe ticker on the local exchange for the associated equity
bloomberg_tickerstrThe Bloomberg identifier for the associated equity
ricstrThe RIC for the associated equity
permidstrThe PermID for the associated equity
isinstrThe ISIN for the associated equity
exchange_micstrThe Exchange market identifier code (MIC) for the associated equity
primary_equityboolWhether the equity is primary for the Aiera-unique company
titlestrThe title of the event
event_type *strThe type of the event
event_datedatetimeThe date and time of the event
has_unknown_timeboolWhether the event time is not yet certainly known
connection_expectedboolWhether we currently expect to connect live to this event
is_liveboolWhether we are currently connected to the live event
machine_publishedboolWhether the post-live machine rebuild of the transcript is complete
machine_published_completeddatetimeTimestamp when the post-live machine rebuild completed
human_verifiedboolWhether there is a human edited/verified transcript available
human_verified_apiboolWhether there is a human edited/verified transcript available by API
human_verified_versionintThe version number for any human edited/verified transcript, if available
human_verified_sourcestrWhere a human edited/verified transcript was sourced, if available
human_verified_source_idstrThird-party identifier for human edited/verified transcript, if available
fiscal_yearintIf event_type is earnings, what fiscal year is relevant
fiscal_quarterintIf event_type is earnings, what fiscal quarter is relevant
conference_numberstrThe dial-in number for this event, if any
broadcast_urlstrThe webcast URL of this event, if any
replay_urlstrThe replay webcast URL of this event, if any
slides_urlstrThe slide presentation URL for this event, if any
slides_url_typestrWhether the slides URL is confirmed or estimated
press_urlstrThe press release URL for this event, if any
press_url_typestrWhether the press_url is confirmed or estimated
public_urlstrThe publicly-accessible URL for this event
public_share_urlstrThe publicly-accessible URL for this event with additional features
transcription_status *strThe status of our live transcription
transcription_audio_urlstrThe URL of the final audio file for this event, if available
transcription_audio_offset_secondsintThe offset from the raw file for the start of the transcript
audio_stream_urlstrThe live HLS stream URL for this event, if available
has_transcriptsboolWhether this event currently has an available transcript
has_api_transcriptboolWhether the event transcript is available in this REST API
has_pricingboolWhether this event currently has pricing information
grouping *objJSON object for metadata around event grouping, such as conference
statusstrThe current status of this event [active or deleted]
createddatetimeWhen this event object was first created in Aiera systems
modifieddatetimeWhen this event was last edited in Aiera systems
linguistics *objJSON object composed of linguistic-extractions, like summaries, etc.
transcriptslistA list of transcripts
company_metadata *objJSON object composed of company metadata, like names, urls, etc.

Possibles

event_type

OptionDescription
earningsA quarterly or annual earnings call
earnings_releaseThe expected release date of earnings information
presentationA conference or other special presentation
shareholder_meetingA known (public or otherwise) shareholder-only meeting
investor_meetingA known (public or otherwise) investor specific meeting
special_situationAn unusual or non-recurring event, like M&A
customA user-generated event (visible only to user and org members

transcription_status

OptionDescription
submittedEvent is queue'd up and waiting
agent_connectedInitial connection has been established
connectedAudio connection has been established and awaiting transcription
startedAudio and transcription are ongoing
finishedThe event has concluded and is awaiting post-processing
archivedThe event has been post-processed and is complete
missedThe event, unfortunately, failed to properly connect

company url_type

OptionDescription
filingsURL for company filings
homeURL for company's homepage
ir_eventsURL for company's investor relation events
ir_homeURL for company's investor relations homepage
ir_newsURL for company's investor relation news
logo_iconURL for company's logo image
youtubeURL for company's official YouTube page

summary_type

OptionDescription
zeroshotFree-form AI summarization that captures main themes and insights in a narrative style
constrainedStructured AI summarization focused on key metrics, facts, and guidance with specific formatting
bulletsConcise bullet-point format highlighting key takeaways (requires review before display)
criticalsFocused 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"
      }
    ]
  }
}
Previous
Tonal Sentiment