Get equity summary

Fetch a detailed summary for a specific equity including leadership, indices, and events

GET /equities-v2/{equity_id}/summary

NOTE

• Events are returned for the past 1 year and upcoming 3 months.

Request

https://premium.aiera.com/api/equities-v2/1/summary

Response

{
  "equity_id": 1,
  "company_id": 1,
  "name": "AMAZON COM INC",
  "common_name": "Amazon",
  "local_ticker": "AMZN",
  "mic": "XNAS",
  "bloomberg_ticker": "AMZN:US",
  "isin": "US0231351067",
  "permid": "4295905494",
  "gics_sector": "Consumer Discretionary",
  "gics_sub_sector": "Broadline Retail",
  "description": "Amazon.com, Inc. engages in the retail sale of consumer products and subscriptions through online and physical stores in North America and internationally.",
  "company_url": "https://www.amazon.com/",
  "ceo_name": "Andrew R. Jassy",
  "country": "US",
  "estimated_next_earnings": "2025-01-30T17:00:00",
  "created": "2017-06-01T00:00:00",
  "modified": "2024-11-11T14:02:12",
  "status": "active",
  "leadership": [
    {
      "name": "Andrew R. Jassy",
      "title": "President and CEO",
      "event_count": 25,
      "last_event_date": "2024-10-31T17:00:00"
    },
    {
      "name": "Brian T. Olsavsky",
      "title": "Senior Vice President and CFO",
      "event_count": 42,
      "last_event_date": "2024-10-31T17:00:00"
    }
  ],
  "indices": [
    "S&P 500",
    "NASDAQ 100"
  ],
  "events": {
    "past": [
      {
        "event_id": 2646352,
        "title": "Q3 2024 Amazon.com Inc Earnings Call",
        "event_type": "earnings",
        "event_date": "2024-10-31T17:00:00",
        "fiscal_quarter": 3,
        "fiscal_year": 2024,
        "conference_number": null,
        "conference_number_alt": null,
        "conference_pin": null,
        "broadcast_url": "https://events.q4inc.com/attendee/878809675",
        "replay_url": "https://events.q4inc.com/attendee/878809675",
        "transcription_status": "published",
        "transcription_connected": "2024-10-31T17:00:15",
        "transcription_disconnected": "2024-10-31T18:02:30",
        "has_human_verified": true,
        "has_live_transcript": true,
        "has_audio": true,
        "has_press_release": true,
        "has_slides": true,
        "duplicate_of": null,
        "created": "2024-10-18T14:43:56",
        "modified": "2024-11-01T03:00:21",
        "price_data": {
          "previous_day_close_price": 186.40,
          "current_day_open_price": 187.80,
          "current_day_close_price": 197.93,
          "price_at_start": 188.25,
          "price_at_end": 198.12,
          "volume_at_start": 25000000,
          "volume_at_end": 75000000
        },
        "summary": {
          "title": "Q3 2024 Earnings Summary",
          "content": {
            "highlights": [
              "Revenue increased 11% year-over-year",
              "AWS growth accelerated to 19%"
            ]
          }
        }
      }
    ],
    "upcoming": [
      {
        "event_id": 2700000,
        "title": "Q4 2024 Amazon.com Inc Earnings Call",
        "event_type": "earnings",
        "event_date": "2025-01-30T17:00:00",
        "fiscal_quarter": 4,
        "fiscal_year": 2024,
        "conference_number": null,
        "conference_number_alt": null,
        "conference_pin": null,
        "broadcast_url": null,
        "duplicate_of": null,
        "created": "2025-01-01T00:00:00",
        "modified": "2025-01-01T00:00:00"
      }
    ]
  }
}

Code Samples

Bash

curl --request GET \
  --url 'https://premium.aiera.com/api/equities-v2/{equity_id}/summary' \
  --header 'X-API-Key: xxx'

Python

import requests
requests.get("https://premium.aiera.com/api/equities-v2/{equity_id}/summary", headers={"X-API-Key": "xxx"})