openapi: 3.1.0
info:
  title: EarningsCall API
  version: '2026-10-16'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-16: 8 operation(s) read from 11 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; EarningsCall has published no machine-readable contract that
    the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 5
    documentation: 3
    pages-with-code: 10
    pages-read: 11
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-16'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://earningscall.biz/docs
  - https://earningscall.biz/docs/authentication
  - https://earningscall.biz/docs/versioning
  - https://earningscall.biz/docs/errors
  - https://earningscall.biz/docs/calendar
  - https://earningscall.biz/docs/events
  - https://earningscall.biz/docs/transcript
  - https://earningscall.biz/docs/symbols
  - https://earningscall.biz/docs/audio
  - https://earningscall.biz/docs/slides
  - https://earningscall.biz/docs/live-events
servers:
- url: https://api.earningscall.dev
paths:
  /audio:
    get:
      operationId: get_audio
      tags:
      - Audio
      summary: Audio Stream the original earnings call MP3.
      x-source: https://earningscall.biz/docs
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /calendar:
    get:
      operationId: get_calendar
      tags:
      - Calendar
      summary: Calendar List the earnings calls scheduled for any date.
      x-source: https://earningscall.biz/docs
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /events:
    get:
      operationId: get_events
      tags:
      - Events
      summary: GET /events
      x-source: https://earningscall.biz/docs
      parameters:
      - name: apikey
        in: query
        required: false
        schema:
          type: string
      - name: exchange
        in: query
        required: false
        schema:
          type: string
      - name: symbol
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl : cURL Python JavaScript Copy curl 'https://api.earningscall.dev/events?apikey=demo&exchange=NASDAQ&symbol=AAPL' cURL Python\
          \ JavaScript Copy curl 'https://api.earningscall.dev/events?apikey=demo&exchange=NASDAQ&symbol=AAPL' import earningscall\ncompany =\
          \ earningscall.get_company( \"AAPL\" )\n for event in company.events():\n print (event.year, event.quarter) import { getCompany } from\
          \ \"earningscal"
  /live:
    get:
      operationId: get_live
      tags:
      - Live
      summary: GET /live
      x-source: https://earningscall.biz/docs/live-events
      parameters:
      - name: apikey
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetLiveResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl Copy curl 'https://api.earningscall.dev/live?apikey=demo' cURL Copy curl 'https://api.earningscall.dev/live?apikey=demo'\
          \ Response JSON Copy { \n \"events\" : [ \n { \n \"exchange\" : \"NASDAQ\" , \n \"symbol\" : \"AAPL\" , \n \"year\" : 2024 , \n \"quarter\"\
          \ : 4 , \n \"company_name\" : \"Apple Inc.\" , \n \"event_date\" : \"2024-11-01T17:00:00+00:00\" , \n \"streaming_url\" : \"https://earningscall.biz/live-demo/dynamic-playl"
  /slides:
    get:
      operationId: get_slides
      tags:
      - Slides
      summary: GET /slides
      x-source: https://earningscall.biz/docs/slides
      parameters:
      - name: apikey
        in: query
        required: false
        schema:
          type: string
      - name: exchange
        in: query
        required: false
        schema:
          type: string
      - name: quarter
        in: query
        required: false
        schema:
          type: string
      - name: symbol
        in: query
        required: false
        schema:
          type: string
      - name: year
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl Python Copy curl --output msft_q1_2025.pdf  ''https://api.earningscall.dev/slides?apikey=demo&exchange=NASDAQ&symbol=MSFT&year=2025&quarter=1''
          cURL Python Copy curl --output msft_q1_2025.pdf  ''https://api.earningscall.dev/slides?apikey=demo&exchange=NASDAQ&symbol=MSFT&year=2025&quarter=1''
          import earningscall

          company = earningscall.get_company( "MSFT" )

          company.download_slide_deck(year= 2025 , '
  /symbols:
    get:
      operationId: get_symbols
      tags:
      - Symbols
      summary: GET /symbols
      x-source: https://earningscall.biz/docs/symbols
      parameters:
      - name: apikey
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetSymbolsResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl Python JavaScript Copy curl 'https://api.earningscall.dev/symbols?apikey=demo' cURL Python JavaScript Copy curl 'https://api.earningscall.dev/symbols?apikey=demo'\
          \ import earningscall\n for company in earningscall.get_all_companies():\n print (company.company_info.symbol, company.name) import\
          \ { getAllCompanies } from \"earningscall\" ;\n const companies = await getAllCompanies ();\n console . log (c"
  /transcript:
    get:
      operationId: get_transcript
      tags:
      - Transcript
      summary: Transcripts Fetch raw text, speaker turns, and word timings.
      x-source: https://earningscall.biz/docs
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v4/events:
    get:
      operationId: get_v4_events
      tags:
      - Events
      summary: GET /v4/events
      x-source: https://earningscall.biz/docs/versioning
      parameters:
      - name: apikey
        in: query
        required: false
        schema:
          type: string
      - name: exchange
        in: query
        required: false
        schema:
          type: string
      - name: symbol
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV4EventsResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl ''https://api.earningscall.dev/v4/events?apikey=demo&exchange=NASDAQ&symbol=AAPL'' '
components:
  schemas:
    GetLiveResponse:
      type: object
      properties:
        events:
          type: array
          items:
            type: object
            properties:
              exchange:
                type: string
              symbol:
                type: string
              year:
                type: integer
              quarter:
                type: integer
              company_name:
                type: string
              event_date:
                type: string
                format: date-time
              streaming_url:
                type: string
              live_transcript:
                type:
                - string
                - 'null'
    GetSymbolsResponse:
      type: object
      properties:
        symbols:
          type: array
          items:
            type: object
            properties:
              exchange:
                type: string
              name:
                type: string
              symbol:
                type: string
    GetV4EventsResponse:
      type: object
      properties:
        symbols:
          type: array
          items:
            type: object
            properties:
              exchange:
                type: string
              name:
                type: string
              symbol:
                type: string
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
security:
- apiKey: []
tags:
- name: Audio
- name: Calendar
- name: Events
- name: Live
- name: Slides
- name: Symbols
- name: Transcript