---
title: "Get the economic schedule known at a historical time"
method: GET
path: "/v1/calendar/{currency}/snapshot"
tags: ["calendar"]
---

# Get the economic schedule known at a historical time

`GET /v1/calendar/{currency}/snapshot`

## Request

- Base URL: `https://api.fxmacrodata.com`
- URL: `https://api.fxmacrodata.com/v1/calendar/{currency}/snapshot`
- Auth: one of:
  - none
  - API key in header `X-API-Key`
  - HTTP bearer

Selects the latest eligible version of each event at as_of before applying scheduled-date, importance and event-kind filters. Times are UTC; date-only events retain their publisher date without an invented UTC time. Includes explicit cancellations. Use the returned checkpoint and cursor on every subsequent page for a consistent export. Historical reconstruction is an explicit evidence-qualified mode. Coverage is reported separately at `/v1/calendar/{currency}/coverage`. Requires an active API key.

## Path parameters

- `currency` 'AUD' | 'BRL' | 'CAD' | 'CHF' | 'CNH' | 'CNY' | 'COMM' | 'DKK' | 'EUR' | 'GBP' | 'HUF' | 'ILS' | 'JPY' | 'KRW' | 'MYR' | 'NGN' | 'NOK' | 'NZD' | 'PEN' | 'SEK' | 'THB' | 'TWD' | 'USD', required

## Query parameters

- `as_of` string, date-time, required: Knowledge cutoff, ISO 8601 with UTC offset.
- `start_date` string, date, nullable
- `end_date` string, date, nullable
- `importance` 'high' | 'medium' | 'low' | 'unknown', nullable
- `event_kind` 'release' | 'speech' | 'meeting' | 'policy_decision' | 'press_conference' | 'other', nullable
- `knowledge_mode` 'accepted' | 'reconstruction'
- `checkpoint` integer, nullable
- `cursor` string, nullable
- `limit` integer
- `api_key` string: Your Individual or Business API key

## Response `200`

Successful Response

- CalendarSnapshot
  - `currency` string, required
  - `as_of` string, required
  - `knowledge_mode` 'accepted' | 'reconstruction', required
  - `checkpoint` integer, required
  - `next_cursor` string, nullable
  - `events` object[], required
  - `evidence_notice` string

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/fxmacrodata/apis/fx-macrodata-api.md) · [All operations](https://skmtc.dev/fxmacrodata/apis/fx-macrodata-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fxmacrodata/apis/fx-macrodata-api/revisions/fadaa543b154?raw)