---
title: "US economic calendar"
method: GET
path: "/v1/fnd/economic-calendar"
tags: ["EconomicCalendar"]
---

# US economic calendar

`GET /v1/fnd/economic-calendar`

## Request

- Base URL: `https://api.sifting.io`
- URL: `https://api.sifting.io/v1/fnd/economic-calendar`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in query parameter `api_key`
- TypeScript: <https://skmtc.dev/sifting/apis/siftingio-market-data-api/docs/v1/fnd/economic-calendar/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `from` string
- `to` string
- `country` string
- `impact` 'low' | 'medium' | 'high'
- `agency` 'BLS' | 'BEA' | 'Census' | 'Fed' | 'DOL' | 'EIA'
- `event_id` string
- `limit` integer

## Response `200`

Economic events.

- EconomicCalendarResponse
  - `events` EconomicEvent[]
    - `event_id` string
    - `name` string
    - `country` string
    - `currency` string
    - `agency` string
    - `impact` string
    - `scheduled_at` string, date-time
    - `actual` number, nullable
    - `previous` number, nullable
    - `consensus` number, nullable
    - `released_at` string, date-time, nullable
  - `count` integer
  - `filter` object

## Other responses

- `400`: Invalid request parameters.
- `401`: Missing or invalid API key.
- `429`: Rate limit exceeded.

---

[API](https://skmtc.dev/sifting/apis/siftingio-market-data-api.md) - [All operations](https://skmtc.dev/sifting/apis/siftingio-market-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sifting/apis/siftingio-market-data-api/revisions/c570068c2359?raw)