# Official economic calendar with figures

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

> Official economic calendar with figures.

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

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

#### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `currencies` | query | string | no | Comma-separated, e.g. USD,EUR. |
| `from` | query | string (date) | no |  |
| `to` | query | string (date) | no |  |
| `kind` | query | string | no | Comma-separated: release, rate_decision, survey, earnings. |
| `impact` | query | string | no | Comma-separated: high, medium, low. |

#### 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 | Stable per series and period, e.g. bls:cpi_mom:2026-10: a rescheduled release keeps its id. |
| `data.events[].title` | string | yes |  |
| `data.events[].occurredAt` | string (date-time) | yes | When the publisher releases it, in UTC. |
| `data.events[].currency` | string | yes | Three-letter currency code. |
| `data.events[].kind` | "release" \| "rate_decision" \| "survey" \| "earnings" | yes |  |
| `data.events[].impact` | "high" \| "medium" \| "low" | yes | fxapis' own ranking by topic, not a market forecast. |
| `data.events[].unit` | null \| string | no | Unit of actual and previous, e.g. %. |
| `data.events[].period` | null \| string | no | The period the figure covers, e.g. Oct 2026 or Q3 2026. |
| `data.events[].previous` | null \| string | no | The publisher's figure for the period before, as it stood before this release. |
| `data.events[].actual` | null \| string | no | The publisher's figure, once released. Surveys never carry figures. |
| `data.events[].revisedPrevious` | null \| string | no | The previous period's figure as revised in this release, when it changed. |
| `data.events[].forecast` | null \| string | no | Consensus forecast. Empty until a licensed forecast source is added. |
| `data.events[].forecastSource` | null \| string | no |  |
| `data.events[].status` | "scheduled" \| "released" \| "delayed" \| "cancelled" | yes |  |
| `data.events[].releasedAt` | null \| string (date-time) | no | When fxapis first had the figure. |
| `data.events[].confirmed` | boolean | yes | False when the publisher's calendar could not be checked recently: the date may have moved. |
| `data.events[].source` | string | yes |  |
| `data.events[].figureSource` | null \| string | no |  |
| `data.events[].attribution` | string | yes | The source credit to show with the event. |
| `data.blsConfigured` | boolean | yes | Whether US labour-market releases (CPI, payrolls) are configured. |
| `data.impactBasis` | string | yes | What the impact ranking is. |
| `requestId` | string | yes |  |