European Central Bank — Consumer Expectations Survey (CES)

DatasetExecutable4/7Query nowOpen workbench Subscribe🇪🇺European

Official time series from the Consumer Expectations Survey (CES) dataset, published by the European Central Bank via its Data Portal as an SDMX 2.1 REST dataflow. The single endpoint can return data in XML (SDMX-ML), CSV, or JSON formats, and specific series can be extracted using a key path together with startPeriod, endPeriod, or lastNObservations filters. The same series can also be browsed and charted interactively on the ECB Data Portal. The survey covers consumer expectations on prices and other economic indicators across the euro area.Consumer Expectations Survey (CES) — official time series from the European Central Bank Data Portal, published as the CES dataflow over SDMX 2.1 REST. One endpoint serves XML (SDMX-ML), CSV (?format=csvdata) and JSON (?format=jsondata); extract exactly the series you need with a key path and startPeriod / endPeriod / lastNObservations filters. Browse and chart the same series on the ECB Data Portal.

economyprices

Run verified request Dataflow structure Fetch observations (JSON)Read the docs Open source record

Data schema (24 fields)

Filterable via the API (8)

FREQREF_AREACES_BREAKDOWNCES_CUSTOMCES_VARIABLECES_ANSWERCES_DENOMTIME_PERIOD

Click a field to see example values.

Field	Type	Description
FREQFrequency	dimension	Frequency of the observations, e.g. monthly or quarterly.2 codes (e.g. Monthly, Quarterly)
REF_AREAReference area	dimension	Country or reference area covered by the observation.13 codes (e.g. Austria, Belgium, Germany)
CES_BREAKDOWNBreakdown for CES survey	dimension	Population breakdown used for the survey, e.g. by age group.9 codes (e.g. No specific breakdown, Age between 18 and 34, Age between 35 and 54)
CES_CUSTOMCustom for CES survey	dimension	Custom classification dimension for the CES survey, typically 'Total'.1 codes (e.g. Total)
CES_VARIABLEVariable for CES survey	dimension	Survey variable measured, e.g. inflation perceptions or expectations.29 codes (e.g. Inflation perceptions over the previous 12 months (qualitative), Inflation perceptions over the previous 12 months (% change), Inflation expectations over the next 12 months (qualitative))
CES_ANSWERConcept for CES survey answers	dimension	Type of survey answer or response category, e.g. increase or decrease.7 codes (e.g. Down/Deteriorated/Decreased/Will decrease, Up/Improved/Increased/Will increase, Net Balance (increased minus decreased responses))
CES_DENOMDenominator for CES survey	dimension	Denominator basis for the value, e.g. weighted share or number of responses.7 codes (e.g. Weighted share, Unweighted number of responses, Weighted number of responses)
TIME_PERIODTime period or range	time	Time period the observation refers to.Time dimension — filter with startPeriod / endPeriod query params.
OBS_VALUEObservation value	number	Numeric value of the observation.The observed numeric value for each cell.
TIME_FORMATTime format code	attribute	Code indicating the format used for the time period.Code indicating the format used for the time period.
BREAKS	attribute	Indicator of breaks in the time series.Indicator of breaks in the time series.
COLLECTIONCollection indicator	attribute	Indicator describing how the data was collected.Indicator describing how the data was collected.
COMPILING_ORGCompiling organisation	attribute	Organisation that compiled the data.Organisation that compiled the data.
DISS_ORGData dissemination organisation	attribute	Organisation responsible for disseminating the data.Organisation responsible for disseminating the data.
COMPILATION	attribute	Information on how the data was compiled.Information on how the data was compiled.
DECIMALS	attribute	Number of decimal places in the observation value.Number of decimal places in the observation value.
TITLE	attribute	Title of the data series.Title of the data series.
TITLE_COMPLTitle complement	attribute	Additional descriptive text supplementing the series title.Additional descriptive text supplementing the series title.
UNIT	attribute	Unit of measurement for the observation value.Unit of measurement for the observation value.
UNIT_MULTUnit multiplier	attribute	Power-of-ten multiplier applied to the observation value.Power-of-ten multiplier applied to the observation value.
OBS_STATUSObservation status	attribute	Status code indicating data quality, e.g. estimated or provisional.Status code indicating data quality, e.g. estimated or provisional.
CONF_STATUSConfidentiality status	attribute	Confidentiality status of the observation.Confidentiality status of the observation.
PRE_BREAK_VALUE	attribute	Value of the series immediately before a break.Value of the series immediately before a break.
COMMENT_OBSComments to the observation value	attribute	Free-text comment attached to the observation.Free-text comment attached to the observation.

Schema captured from sdmx 1 month ago.

Query the data

Pick columns and a sort, then fetch a live preview straight from the source. Choose an API-filterable column (marked ▾) under “Where” to pick from its list of values.

Where=

Sort by

Sample data (5 records)

Record 1FREQ: M · REF_AREA: AT

{
  "FREQ": "M",
  "REF_AREA": "AT",
  "CES_DENOM": "WS",
  "OBS_VALUE": 5.4,
  "CES_ANSWER": "DEC",
  "CES_CUSTOM": "T",
  "TIME_PERIOD": "2026-06",
  "CES_VARIABLE": "C1010",
  "CES_BREAKDOWN": "ALL"
}

Record 2FREQ: M · REF_AREA: AT

{
  "FREQ": "M",
  "REF_AREA": "AT",
  "CES_DENOM": "WS",
  "OBS_VALUE": 90.3,
  "CES_ANSWER": "INC",
  "CES_CUSTOM": "T",
  "TIME_PERIOD": "2026-06",
  "CES_VARIABLE": "C1010",
  "CES_BREAKDOWN": "ALL"
}

Record 3FREQ: M · REF_AREA: AT

{
  "FREQ": "M",
  "REF_AREA": "AT",
  "CES_DENOM": "WS",
  "OBS_VALUE": 84.9,
  "CES_ANSWER": "NB",
  "CES_CUSTOM": "T",
  "TIME_PERIOD": "2026-06",
  "CES_VARIABLE": "C1010",
  "CES_BREAKDOWN": "ALL"
}

Record 4FREQ: M · REF_AREA: AT

{
  "FREQ": "M",
  "REF_AREA": "AT",
  "CES_DENOM": "UN",
  "OBS_VALUE": 980,
  "CES_ANSWER": "NUM_VAR",
  "CES_CUSTOM": "T",
  "TIME_PERIOD": "2026-06",
  "CES_VARIABLE": "C1010",
  "CES_BREAKDOWN": "ALL"
}

Record 5FREQ: M · REF_AREA: AT

{
  "FREQ": "M",
  "REF_AREA": "AT",
  "CES_DENOM": "WN",
  "OBS_VALUE": 7578523,
  "CES_ANSWER": "NUM_VAR",
  "CES_CUSTOM": "T",
  "TIME_PERIOD": "2026-06",
  "CES_VARIABLE": "C1010",
  "CES_BREAKDOWN": "ALL"
}

Live sample captured at profiling time — values may have changed upstream.

Verification Status

Using the API

Query examples

curl -s 'https://data-api.ecb.europa.eu/service/dataflow/ECB' -H 'Accept: application/vnd.sdmx.structure+xml;version=2.1'

All dataflows (datasets) published by this agency, as SDMX-ML.

Full API documentation ↗

Machine-readable & source

JSON

Embed this badge in a README or wiki — it always shows the latest verification state and quality tier.