---
title: "Get a single economic calendar event including its revision history"
method: GET
path: "/rest/api/v1/projects/{projectId}/economicCalendar/{eventId}"
tags: ["News API"]
---

# Get a single economic calendar event including its revision history

`GET /rest/api/v1/projects/{projectId}/economicCalendar/{eventId}`

## Request

- Base URL: `https://api.metacopier.io`
- URL: `https://api.metacopier.io/rest/api/v1/projects/{projectId}/economicCalendar/{eventId}`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/metacopier/apis/metacopier-api/docs/rest/api/v1/projects/:projectId/economicCalendar/:eventId/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `projectId` string, uuid, required
- `eventId` string, required

## Response `200`

OK

- CalendarEventDTO: Economic calendar event, normalised across all sources
  - `actual` string: Released value as a display string
  - `actualRaw` number, double: Released value, numeric
  - `actualReleasedAt` string, date-time: When the actual value first became available
  - `allDay` boolean: True when the source gives a day but no exact time
  - `category` string: Source category
  - `commentEn` string: Explanation rewritten by us in English, at most 150 characters
  - `countryCode` string: ISO-3166 alpha-2, EU for the eurozone, null for global events
  - `currencyCode` string: ISO-4217 currency, ALL for global events
  - `dedupKey` string: Stable hash identifying the same event across sources
  - `disputed` boolean: True when sources disagree on the time by more than 30 minutes
  - `eventTimeUtc` string, date-time: Release time in UTC
  - `firstSeenAt` string, date-time: When this event was first ingested
  - `forecast` string: Consensus forecast as a display string
  - `forecastRaw` number, double: Consensus forecast, numeric
  - `id` string: MongoDB document id
  - `impact` 'HOLIDAY' | 'LOW' | 'MEDIUM' | 'HIGH': Impact classification
  - `indicator` string: Normalised indicator name
  - `indicatorKey` string: Stable key for statistics: countryCode|normalisedIndicator
  - `lastUpdatedAt` string, date-time: When this event was last written
  - `period` string: Reference period
  - `previous` string: Previous value as a display string
  - `previousRaw` number, double: Previous value, numeric
  - `revision` integer: Incremented whenever the time or the forecast changes
  - `revisions` CalendarEventRevisionDTO[]: What changed and when, for the revised badge
    - `changedAt` string, date-time: When the change was observed
    - `field` string: Field that changed
    - `newValue` string: Value after the change
    - `oldValue` string: Value before the change
  - `scale` string: Scale of the values
  - `surpriseSigma` number, double: (actual - forecast) divided by the historic surprise standard deviation
  - `title` string: Event title as published
  - `titleEn` string: Title rewritten by us in English, at most 150 characters
  - `unit` string: Unit of the values

## Changes

- **2026-08-30** `69d2d39c695e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/metacopier/apis/metacopier-api/changes/rest/api/v1/projects/:projectId/economicCalendar/:eventId/get.md)

---

[API](https://skmtc.dev/metacopier/apis/metacopier-api.md) - [All operations](https://skmtc.dev/metacopier/apis/metacopier-api/llms.txt) - [OpenAPI document](https://skmtc.dev/metacopier/apis/metacopier-api/revisions/2ac6d7461345?raw)
