# Official economic calendar

URL: https://docs.fxapis.com/api-reference/marketlabs/official-economic-calendar

> Official economic calendar.

`GET https://api.fxapis.com/v1/marketlabs/events`

Authentication: `Authorization: Bearer <API key>`.

#### Responses

- `200`
- `400`
- `401`
- `402`
- `403`
- `404`
- `409`
- `503`

Failures return `{ "error": { "code", "message" } }`; every code is listed at https://docs.fxapis.com/errors.

#### 200 response fields

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `data` | object | yes |  |
| `data.events` | object[] | yes |  |
| `data.events[].id` | string | yes |  |
| `data.events[].title` | string | yes |  |
| `data.events[].occurredAt` | string (date-time) | yes |  |
| `data.events[].currency` | string | yes | Three-letter currency code. |
| `data.events[].previous` | null \| string | no |  |
| `data.events[].actual` | null \| string | no |  |
| `data.events[].forecast` | null | no |  |
| `data.events[].impact` | "high" \| "medium" \| "low" | yes |  |
| `data.events[].source` | string | yes |  |
| `data.events[].attribution` | string | yes |  |
| `data.blsConfigured` | boolean | yes | Whether US labour-market releases (CPI, payrolls) are configured. |
| `requestId` | string | yes |  |