---
title: "Earnings calendar"
method: GET
path: "/earnings_calendar"
tags: ["fundamentals"]
---

# Earnings calendar

`GET /earnings_calendar`

The earnings calendar endpoint provides a schedule of company earnings announcements for a specified date range. By default, it returns earnings data for the current day. Users can customize the date range using the `start_date` and `end_date` parameters to retrieve earnings information for specific periods. This endpoint is useful for tracking upcoming earnings reports and planning around key financial announcements.

## Query parameters

- `exchange` string
- `mic_code` string
- `country` string
- `format` 'JSON' | 'CSV'
- `delimiter` string
- `start_date` string
- `end_date` string
- `dp` integer

## Response `200`

- object
  - `earnings` object, required — Map of dates to earnings data
  - `status` string, required — Response status

## Other responses

- `400`
- `401`
- `403`
- `404`
- `414`
- `429`
- `500`

---

[API](https://skmtc.net/twelvedata/apis/twelve-data-api.md) · [All operations](https://skmtc.net/twelvedata/apis/twelve-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twelvedata/twelve-data-api/revisions/c4a12725cdb5/schema)