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

# Returns the economic calendar data

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

Returns economic calendar data including economic indicators, releases, and reports from various countries. Includes actual values, consensus estimates, and prior values for economic events such as GDP, employment data, inflation metrics, and more.

## 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[importance]` 1 | 2 | 3
- `parameters[updated]` integer
- `country` string, A-Z:3
- `event_name` string, csv
- `event_category` string, csv

## Headers

- `accept` 'application/json', required

## Response `200`

success

- ApiEconomicResponse — API response containing an array of economic event records
  - `economics` GitlabBenzingaIoBenzingaBzgoPkgModelsCalendarApiEconomic[]
    - `actual` string
    - `actual_t` string
    - `confirmed` boolean
    - `consensus` string
    - `consensus_t` string
    - `country` string
    - `date` string
    - `description` string
    - `event_category` string
    - `event_name` string
    - `event_period` string
    - `id` string
    - `importance` integer
    - `notes` string
    - `period_year` integer
    - `prior` string
    - `prior_t` string
    - `time` string — Time of the economic event release (EST)
    - `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)