Dictionary

Event

The data dictionary and definitions for Events

Fields

ParameterDescription
event_idThe Aiera-unique identifier for the event
company_idThe Aiera-unique identifier for the associated company
equity_idThe Aiera-unique identifier for the associated equity
tickerThe ticker on the local exchange for the associated equity
local_tickerThe ticker on the local exchange for the associated equity
bloomberg_tickerThe Bloomberg identifier for the associated equity
ricThe RIC for the associated equity
permidThe PermID for the associated equity
isinThe ISIN for the associated equity
exchange_micThe Exchange market identifier code (MIC) for the associated equity
primary_equityWhether the equity is primary for the Aiera-unique company
titleThe title of the event
event_type *The type of the event
event_dateThe date and time of the event
has_unknown_timeWhether the event time is not yet certainly known
connection_expectedWhether we currently expect to connect live to this event
is_liveWhether we are currently connected to the live event
machine_publishedWhether the post-live machine rebuild of the transcript is complete
machine_published_completedTimestamp when the post-live machine rebuild completed
fiscal_yearIf event_type is earnings, what fiscal year is relevant
fiscal_quarterIf event_type is earnings, what fiscal quarter is relevant
conference_numberThe dial-in number for this event, if any
broadcast_urlThe webcast URL of this event, if any
replay_urlThe replay webcast URL of this event, if any
slides_urlThe slide presentation URL for this event, if any
slides_url_typeWhether the slides URL is confirmed or estimated
press_urlThe press release URL for this event, if any
press_url_typeWhether the press_url is confirmed or estimated
public_urlThe publicly-accessible URL for this event
public_share_urlThe publicly-accessible URL for this event with additional features
transcription_status *The status of our live transcription
transcription_audio_urlThe URL of the final audio file for this event, if available
transcription_audio_offset_secondsThe offset from the raw file for the start of the transcript
audio_stream_urlThe live HLS stream URL for this event, if available
has_transcriptsWhether this event currently has an available transcript
has_api_transcriptWhether the event transcript is available in this REST API
has_pricingWhether this event currently has pricing information
statusThe current status of this event [active or deleted]
createdWhen this event object was first created in Aiera systems
modifiedWhen this event was last edited in Aiera systems
linguistics *JSON object composed of linguistic-extractions, like summaries, etc.
transcriptsA list of transcripts
company_metadata *JSON 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

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
Next
Transcript