Endpoints

Slides

Download the slide deck PDF that accompanies an earnings call.

GEThttps://v2.api.alpha.earningscall.biz/slides

Streams the slide deck PDF for a given earnings call. Slide deck access is restricted to Enterprise plans (Demo accounts may also access for testing).

Use the companion /slides-metadata endpoint to discover whether slides are available for a company before requesting the PDF.

Parameters#

ParameterTypeDescription
apikeystringRequiredYour API key.
exchangestringRequiredStock exchange, e.g. NASDAQ.
symbolstringRequiredTicker symbol.
yearintegerRequired4-digit year of the earnings call.
quarterintegerRequiredFiscal quarter, 1–4.

Examples#

Download a slide deck#

curl --output msft_q1_2025.pdf \
  'https://v2.api.alpha.earningscall.biz/slides?apikey=demo&exchange=NASDAQ&symbol=MSFT&year=2025&quarter=1'

Response

Binary application/pdf stream — saved to disk by the caller.

Discover available slides via /slides-metadata#

GET /slides-metadata is a separate endpoint that returns JSON metadata describing which slide decks are available for a company. Authentication is required, but no plan restriction is applied — every authenticated user can list metadata.

curl 'https://v2.api.alpha.earningscall.biz/slides-metadata?apikey=demo&exchange=NASDAQ&symbol=AAPL'

Response

{
  "company_name": "Apple Inc.",
  "symbol": "AAPL",
  "exchange": "NASDAQ",
  "slides": [
    {
      "year": 2025,
      "quarter": 1,
      "available": true,
      "pages": 24,
      "file_size_mb": 2.8
    },
    {
      "year": 2024,
      "quarter": 4,
      "available": true,
      "pages": 22,
      "file_size_mb": 2.5
    }
  ]
}

Error responses#

See the Errors page for the full error format. This endpoint can return:

400missing_parameter — Missing exchange, symbol, year, or quarter.400invalid_parameter — Non-integer or out-of-range value.401invalid_api_key — Auth failure.403demo_restriction — Demo account requesting a ticker other than AAPL or MSFT on NASDAQ.403plan_restriction — Plan does not include slides access.404resource_not_found — Slides not available for the requested call.429rate_limit_exceeded — Plan rate limit exceeded.

Plan access#

Slide PDF downloads require Enterprise or Enterprise Plus. The /slides-metadata endpoint has no plan restriction.