---
title: "Get Economic Events Calendar"
method: GET
path: "/economics/calendar"
tags: ["Economics"]
---

# Get Economic Events Calendar

`GET /economics/calendar`

## Request

- Base URL: `https://data.finbud.ai/api`
- URL: `https://data.finbud.ai/api/economics/calendar`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/laksmono---company/apis/finbud-api/docs/economics/calendar/get.ts> (a function with typed inputs; its response is checked against the schema)

Fetches a calendar of upcoming or past economic events (e.g., CPI release, FOMC meeting) for a specified date range.

## Query parameters

- `from` string, date
- `to` string, date

## Response `200`

Successful response with an array of economic calendar events.

- object[]
  - `date` string, date-time
  - `event` string
  - `country` string
  - `actual` number, nullable
  - `previous` number, nullable
  - `change` number, nullable
  - `change-percentage` number, nullable
  - `estimate` number, nullable
  - `impact` string: Estimated market impact level (e.g., Low, Medium, High).

## Other responses

- `400`: Bad Request - Invalid date format for 'from' or 'to' parameters.
- `404`: Not Found - No economic events found for the specified date range.
- `500`: Internal Server Error - Failed to fetch data or other server error.

---

[API](https://skmtc.dev/laksmono---company/apis/finbud-api.md) - [All operations](https://skmtc.dev/laksmono---company/apis/finbud-api/llms.txt) - [OpenAPI document](https://skmtc.dev/laksmono---company/apis/finbud-api/revisions/742d2654c09a?raw)