News API

Get a single economic calendar event including its revision history

Changed on
get/rest/api/v1/projects/{projectId}/economicCalendar/{eventId}

Request

Path parameters

projectIdstring uuid required
eventIdstring required

Response

OK

actualstring

Released value as a display string

actualRawnumber double

Released value, numeric

actualReleasedAtstring date-time

When the actual value first became available

allDayboolean

True when the source gives a day but no exact time

categorystring

Source category

commentEnstring

Explanation rewritten by us in English, at most 150 characters

countryCodestring

ISO-3166 alpha-2, EU for the eurozone, null for global events

currencyCodestring

ISO-4217 currency, ALL for global events

dedupKeystring

Stable hash identifying the same event across sources

disputedboolean

True when sources disagree on the time by more than 30 minutes

eventTimeUtcstring date-time

Release time in UTC

firstSeenAtstring date-time

When this event was first ingested

forecaststring

Consensus forecast as a display string

forecastRawnumber double

Consensus forecast, numeric

idstring

MongoDB document id

impact'HOLIDAY' | 'LOW' | 'MEDIUM' | 'HIGH'

Impact classification

indicatorstring

Normalised indicator name

indicatorKeystring

Stable key for statistics: countryCode|normalisedIndicator

lastUpdatedAtstring date-time

When this event was last written

periodstring

Reference period

previousstring

Previous value as a display string

previousRawnumber double

Previous value, numeric

revisioninteger

Incremented whenever the time or the forecast changes

scalestring

Scale of the values

surpriseSigmanumber double

(actual - forecast) divided by the historic surprise standard deviation

titlestring

Event title as published

titleEnstring

Title rewritten by us in English, at most 150 characters

unitstring

Unit of the values

Example response

{
  "actual": "0.3%",
  "actualRaw": 0.3,
  "category": "prce",
  "countryCode": "US",
  "currencyCode": "USD",
  "forecast": "0.2%",
  "forecastRaw": 0.2,
  "indicator": "core cpi mm",
  "indicatorKey": "US|core cpi mm",
  "period": "Jul",
  "previous": "0.1%",
  "previousRaw": 0.1,
  "revision": 1,
  "revisions": [
    {
      "field": "eventTimeUtc",
      "newValue": "2026-08-12T14:30:00Z",
      "oldValue": "2026-08-12T12:30:00Z"
    }
  ],
  "scale": "K",
  "surpriseSigma": 2.4,
  "title": "Core CPI m/m",
  "unit": "%"
}

Changes