---
title: "Returns the earnings data"
method: GET
path: "/api/v2.1/calendar/earnings"
tags: ["earnings"]
---

# Returns the earnings data

`GET /api/v2.1/calendar/earnings`

Returns earnings data for a selected period and/or security. Includes actual EPS and revenue figures, estimates, surprises, and historical comparisons. Earnings data is crucial for investors to assess company performance.

## Query parameters

- `page` integer
- `pagesize` integer
- `parameters[date]` string, YYYY-MM-DD
- `parameters[date_from]` string, YYYY-MM-DD
- `parameters[date_to]` string, YYYY-MM-DD
- `parameters[date_sort]` 'date'
- `parameters[importance]` 0 | 1 | 2 | 3 | 4 | 5
- `parameters[tickers]` string, csv
- `parameters[updated]` integer

## Headers

- `accept` 'application/json', required

## Response `200`

success

- ApiEarningResponse — API response containing an array of earnings records
  - `earnings` GitlabBenzingaIoBenzingaBzgoPkgModelsCalendarApiEarning[]
    - `currency` string
    - `cusip` string
    - `date` string
    - `date_confirmed` integer
    - `eps` string
    - `eps_est` string
    - `eps_prior` string
    - `eps_surprise` string
    - `eps_surprise_percent` string
    - `eps_type` string
    - `exchange` string
    - `id` string
    - `importance` integer
    - `isin` string
    - `name` string
    - `notes` string
    - `period` string
    - `period_year` integer
    - `revenue` string
    - `revenue_est` string
    - `revenue_prior` string
    - `revenue_surprise` string
    - `revenue_surprise_percent` string
    - `revenue_type` string
    - `ticker` string
    - `time` string
    - `updated` integer

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.dev/benzinga/apis/data-api-proxy.md) · [All operations](https://skmtc.dev/benzinga/apis/data-api-proxy/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/benzinga/data-api-proxy/revisions/ea334a9e2e05/schema)