---
title: "Get Upcoming Earnings Calls"
method: GET
path: "/api/v1/earnings/upcoming"
tags: ["Earnings"]
---

# Get Upcoming Earnings Calls

`GET /api/v1/earnings/upcoming`

## Request

- Base URL: `https://earningscalls.dev`
- URL: `https://earningscalls.dev/api/v1/earnings/upcoming`
- Auth: API key in header `X-API-Key`

Get scheduled earnings calls that have not yet occurred. Combines data from earnings_calendar (upcoming) and earnings_calls (if any future entries exist). Upcoming rows carry no venue identity, so `mic` is rejected with 400 rather than silently ignored. Calendar rows resolve to an issuer by symbol where that mapping is unambiguous.

## Query parameters

- `limit` integer
- `days` integer
- `symbol` string
- `symbols` string
- `issuer_id` string
- `issuer_ref` string
- `group_by` 'issuer'
- `mic` string

## Response `200`

Default Response

---

[API](https://skmtc.dev/earningscalls/apis/earnings-call-transcripts-api.md) · [All operations](https://skmtc.dev/earningscalls/apis/earnings-call-transcripts-api/llms.txt) · [OpenAPI document](https://skmtc.dev/earningscalls/apis/earnings-call-transcripts-api/revisions/00131591f434?raw)