---
title: "Get calendar events"
method: GET
path: "/v4/user/calendar"
tags: ["Calendar (v4)"]
---

# Get calendar events

`GET /v4/user/calendar`

## Request

- Base URL: `https://trading-api.oanda.com` (the document declares no server; this is the origin it was published from)
- URL: `https://trading-api.oanda.com/v4/user/calendar`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/oanda/apis/up-gateway-v1/docs/v4/user/calendar/get.ts> (a function with typed inputs; its response is checked against the schema)

Get economic calendar events for the user

## Query parameters

- `divisionId` number, required: OC: 1, CANADA: 2, OAP: 3, OEL: 4, TEST: 5, ECP: 6, OAP_CFD: 7, OCI: 8, OJ_NON_CORPORATE: 9, OJ_CORPORATE: 10, OAU: 11, OEM: 12, OGM: 13, OT: 14 OPUC: 17
- `from` string
- `to` string
- `language` 'en' | 'ar' | 'de' | 'ru' | 'zh' | 'ja' | 'nl' | 'fa' | 'fr' | 'el' | 'it' | 'ko' | 'pt' | 'es' | 'tr' | 'pl': ISO 639-1 language code

## Response `200`

Calendar events retrieved successfully

- object
  - `data` object[], required
    - `id` integer, required
    - `timestamp` string, date-time, required
    - `event` string, required
    - `country` string, required
    - `priority` number, required
    - `period` string, required
    - `actual` string, required
    - `forecast` string, required
    - `previous` string, required
    - `icon` string, required: URL of the icon for the event

## Other responses

- `400`: Bad request - Invalid parameters

---

[API](https://skmtc.dev/oanda/apis/up-gateway-v1.md) - [All operations](https://skmtc.dev/oanda/apis/up-gateway-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/oanda/apis/up-gateway-v1/revisions/395d645513bf?raw)