---
title: "Get immutable schedule versions for an event"
method: GET
path: "/v1/calendar/{currency}/events/{archive_event_id}/versions"
tags: ["calendar"]
---

# Get immutable schedule versions for an event

`GET /v1/calendar/{currency}/events/{archive_event_id}/versions`

## Request

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

Returns accepted versions and their source, capture and documentary evidence. The archive event ID remains stable when its scheduled time changes; existing calendar_event_id values on the current calendar retain their original meaning. Reuse checkpoint and cursor to continue an export. 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
- `archive_event_id` string, required

## Query parameters

- `checkpoint` integer, nullable
- `cursor` string, nullable
- `limit` integer
- `api_key` string: Your Individual or Business API key

## Response `200`

Successful Response

- CalendarVersions
  - `currency` string, required
  - `archive_event_id` string, required
  - `checkpoint` integer, required
  - `next_cursor` string, nullable
  - `versions` object[], required

## 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)