earningscalls-dev Companies API

openapi: 3.2.0
info:
  title: Earnings Call Transcripts Companies API
  description: Access our growing archive of earnings call transcripts from publicly traded companies across 70+ countries and 175+ exchanges. Full-text search, speaker segments, and structured data.
  version: 1.0.0
  contact:
    name: API Support
    url: https://earningscalls.dev
servers:
- url: https://earningscalls.dev
  description: Production server
security:
- ApiKeyAuth: []
tags:
- name: Companies
  description: Company search and details
paths:
  /api/v1/companies/:
    get:
      summary: List Companies
      tags:
      - Companies
      description: List all companies with earnings calls. Returns company metadata, call counts, and date range of available calls.
      parameters:
      - schema:
          type: integer
          minimum: 1
          default: 1
        in: query
        name: page
        required: false
      - schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 20
        in: query
        name: limit
        required: false
      - schema:
          type: string
        in: query
        name: search
        required: false
        description: Search by company name
      - schema:
          type: string
        in: query
        name: sector
        required: false
        description: Filter by sector
      - schema:
          type: string
        in: query
        name: industry
        required: false
        description: Filter by industry
      - schema:
          type: string
        in: query
        name: exchange
        required: false
        description: Filter by exchange
      - schema:
          type: string
          enum:
          - name_asc
          - name_desc
          - calls_desc
          - calls_asc
          default: name_asc
        in: query
        name: sort
        required: false
      responses:
        '200':
          description: Default Response
      operationId: getApiV1Companies
      x-operation-id-source: derived
  /api/v1/companies/ticker/{ticker}:
    get:
      summary: Get Company by Ticker
      tags:
      - Companies
      description: Get company details and all earnings calls by stock ticker symbol. A bare symbol (e.g. `ALV`) returns every venue it is listed on; when that spans multiple companies the response includes a `venues` array. To pin one listing, pass a venue-suffixed ticker (e.g. `ALV:US`, `AIR:FR` — the exact value from any event's `company_ticker`), or use the `mic`/`exchange`/`country` filters. If no rows match, known cross-listing aliases resolve to the issuer's primary record (e.g. `TSM` returns the same issuer as `2330`).
      parameters:
      - schema:
          type: string
        in: query
        name: exchange
        required: false
        description: Filter by exchange name, exact (e.g. NASDAQ, NSEI). Use `mic` for the ISO-10383 form.
      - schema:
          type: string
        in: query
        name: mic
        required: false
        description: ISO 10383 Market Identifier Code (e.g. XNAS, XNSE) — disambiguates symbol collisions across venues.
      - schema:
          type: string
        in: query
        name: country
        required: false
        description: Filter by ISO-3166 alpha-2 country code (e.g. US, IN, CA)
      - schema:
          type: string
        in: path
        name: ticker
        required: true
        description: Stock ticker symbol (e.g., AAPL, MSFT)
      responses:
        '200':
          description: Default Response
      operationId: getApiV1CompaniesTickerByTicker
      x-operation-id-source: derived
  /api/v1/companies/ticker/{ticker}/latest:
    get:
      summary: Get Latest Call by Ticker
      tags:
      - Companies
      description: Get the most recent earnings call for a specific stock ticker. Pass a venue-suffixed ticker (e.g. `ALV:US`) or use `mic`/`exchange`/`country` to disambiguate when the symbol is listed on multiple venues. If no rows match, known cross-listing aliases resolve to the issuer's primary record (e.g. `TSM` returns the same issuer as `2330`).
      parameters:
      - schema:
          type: string
        in: query
        name: exchange
        required: false
        description: Filter by exchange name, exact (e.g. NASDAQ, NSEI). Use `mic` for the ISO-10383 form.
      - schema:
          type: string
        in: query
        name: mic
        required: false
        description: ISO 10383 Market Identifier Code (e.g. XNAS, XNSE) — disambiguates symbol collisions across venues.
      - schema:
          type: string
        in: query
        name: country
        required: false
        description: Filter by ISO-3166 alpha-2 country code (e.g. US, IN, CA)
      - schema:
          type: string
        in: path
        name: ticker
        required: true
        description: Stock ticker symbol (e.g., AAPL, MSFT)
      responses:
        '200':
          description: Default Response
      operationId: getApiV1CompaniesTickerByTickerLatest
      x-operation-id-source: derived
  /api/v1/companies/{name}:
    get:
      summary: Get Company by Name
      tags:
      - Companies
      description: Get company details including all available earnings calls for that company.
      parameters:
      - schema:
          type: string
        in: path
        name: name
        required: true
        description: Company name (URL-encoded)
      responses:
        '200':
          description: Default Response
      operationId: getApiV1CompaniesByName
      x-operation-id-source: derived
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: API key obtained from the dashboard after registration