## Get Economic Calendar Events

`CalendarGetEconomicEventsCalendarResponse v1().calendar().getEconomicEventsCalendar(CalendarGetEconomicEventsCalendarParamsparams = CalendarGetEconomicEventsCalendarParams.none(), RequestOptionsrequestOptions = RequestOptions.none())`

**get** `/v1/calendars/economic-events`

Retrieves macroeconomic calendar events (e.g. CPI, jobs reports, central
bank rate decisions), optionally filtered by country, impact, and event
time range.

Absent a `timestamp` lower bound, results default to events from the
start of the previous trading day (America/New_York); absent an upper
bound, results default through 7 days from today (America/New_York).

### Parameters

- `CalendarGetEconomicEventsCalendarParams params`

  - `Optional<String> country`

    Comma-separated ISO 3166-1 alpha-2 country codes (or `EU`) to filter by. Defaults to `US` when omitted.

  - `Optional<List<Impact>> impact`

    Comma-separated impact levels to filter by.

    - `NONE("NONE")`

    - `LOW("LOW")`

    - `MEDIUM("MEDIUM")`

    - `HIGH("HIGH")`

  - `Optional<Long> pageSize`

    The number of items to return per page. Only used when page_token is not provided.

  - `Optional<String> pageToken`

    Token for retrieving the next or previous page of results. Contains encoded pagination state; when provided, page_size is ignored.

  - `Optional<Timestamp> timestamp`

    - `Optional<String> gt`

      Return only rows where `timestamp` is strictly after the given value. A bare `YYYY-MM-DD` date expands to the end of that day (UTC), so this matches from the start of the following day. See [Range filters](https://docs.clearstreet.com/guides/api-fundamentals#range-filters) for accepted formats, bare-date expansion, and combining bounds. Returns 400 if the resulting range is inverted.

    - `Optional<String> gte`

      Return only rows where `timestamp` is on or after the given value. A bare `YYYY-MM-DD` date expands to the start of that day (UTC). See [Range filters](https://docs.clearstreet.com/guides/api-fundamentals#range-filters) for accepted formats, bare-date expansion, and combining bounds. Returns 400 if the resulting range is inverted.

    - `Optional<String> lt`

      Return only rows where `timestamp` is strictly before the given value. A bare `YYYY-MM-DD` date expands to the start of that day (UTC). See [Range filters](https://docs.clearstreet.com/guides/api-fundamentals#range-filters) for accepted formats, bare-date expansion, and combining bounds. Returns 400 if the resulting range is inverted.

    - `Optional<String> lte`

      Return only rows where `timestamp` is on or before the given value. A bare `YYYY-MM-DD` date expands to the end of that day (UTC), so this matches through the end of that day. See [Range filters](https://docs.clearstreet.com/guides/api-fundamentals#range-filters) for accepted formats, bare-date expansion, and combining bounds. Returns 400 if the resulting range is inverted.

### Returns

- `class CalendarGetEconomicEventsCalendarResponse:`

  - `List<EconomicEvent> data`

    - `String country`

      ISO 3166-1 alpha-2 country code, or `EU`.

    - `String name`

      Event name as reported by the provider.

    - `LocalDateTime timestamp`

      UTC instant of the event.

    - `Optional<String> actual`

      Actual reported value. Null before the print, or if the provider never
      reports one for this event.
      When a null/undefined value is observed, it indicates that there is no available data.

    - `Optional<String> change`

      Change from the previous value.
      When a null/undefined value is observed, it indicates that there is no available data.

    - `Optional<String> changePercentage`

      Change from the previous value, as a percentage.
      When a null/undefined value is observed, it indicates that there is no available data.

    - `Optional<String> currency`

      Currency associated with the event, if applicable.
      When a null/undefined value is observed, it indicates that there is no available data.

    - `Optional<String> estimate`

      Analyst-estimated value.
      When a null/undefined value is observed, it indicates that there is no available data.

    - `Optional<EconomicEventImpact> impact`

      Expected market impact, if known.
      When a null/undefined value is observed, it indicates that there is no available data.

      - `NONE("NONE")`

      - `LOW("LOW")`

      - `MEDIUM("MEDIUM")`

      - `HIGH("HIGH")`

    - `Optional<String> previous`

      Previous period's reported value.
      When a null/undefined value is observed, it indicates that there is no available data.

    - `Optional<String> unit`

      Unit of the numeric value fields, if known.
      When a null/undefined value is observed, it indicates that there is no available data.

### Example

```java
package com.clearstreet.api.example;

import com.clearstreet.api.client.ClearStreetClient;
import com.clearstreet.api.client.okhttp.ClearStreetOkHttpClient;
import com.clearstreet.api.models.v1.calendar.CalendarGetEconomicEventsCalendarParams;
import com.clearstreet.api.models.v1.calendar.CalendarGetEconomicEventsCalendarResponse;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        ClearStreetClient client = ClearStreetOkHttpClient.builder()
            .fromEnv()
            .apiKey("My API Key")
            .build();

        CalendarGetEconomicEventsCalendarResponse response = client.v1().calendar().getEconomicEventsCalendar();
    }
}
```

#### Response

```json
{
  "data": [
    {
      "actual": null,
      "change": null,
      "change_percentage": null,
      "country": "US",
      "currency": "USD",
      "estimate": "0.30",
      "impact": "HIGH",
      "name": "CPI m/m",
      "previous": "0.20",
      "timestamp": "2025-11-05T13:30:00.000000000Z",
      "unit": "%"
    }
  ],
  "error": null,
  "metadata": {
    "request_id": "0f1a2b3c-4d5e-6f78-9012-3a4b5c6d7e8f"
  }
}
```