---
title: "List of macro events"
method: GET
path: "/api/v1/macro_events"
tags: ["Macro events"]
---

# List of macro events

`GET /api/v1/macro_events`

Provides a list of significant macroeconomic events, including key metrics and country-specific information.

### Available Data Points:

*   **Title:** Short descriptive title of the event.
*   **Date:** The date of the event in \`YYYY-MM-DD\` format.
*   **Datetime:** The exact date and time in \`YYYY-MM-DDTHH:mm:ssZ\` format (ISO 8601), if applicable.
*   **Actual Value:** Reported or observed value for the event.
*   **Expectation:** Forecast or expected value for the event.
*   **Surprise:** Comparison or difference between actual and expected values.
*   **Previous:** Value reported during the previous reporting period.
*   **Country iso2:** Two-letter ISO country code (e.g., US, UK, DE).
*   **Category:** Broad classification of the event (e.g., GDP, inflation, employment).

**Try it out!** You can test the API with the **trial key** `TEST`. Simply include it in your request headers; either here, or add the header `"Ortex-Api-Key": "TEST"` to your http request.

**Trial key restrictions:** A list of randomly selected rows will be returned

**Get full access!** Get a key at [app.ortex.com/apis](https://app.ortex.com/apis)

## Query parameters

- `country` string, required
- `from_date` string
- `page` integer
- `page_size` integer
- `to_date` string

## Response `200`

- PaginatedMacroEventsList
  - `paginationLinks` object
  - `length` integer, required
  - `rows` MacroEvents[], required
    - `title` string, required
    - `date` string, date, required
    - `datetime` string, date-time, required
    - `actualValue` string
    - `expectation` string, required
    - `surprise` string, required
    - `previous` string, required
    - `countryIso2` string
    - `category` string, required
  - `creditsUsed` integer
  - `creditsLeft` integer

## Other responses

- `400` — Invalid request parameters
- `403` — Not authorized
- `404` — Data not found
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.dev/ortex/apis/ortex-apis.md) · [All operations](https://skmtc.dev/ortex/apis/ortex-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ortex/ortex-apis/revisions/2629fc613cdc/schema)