Different units
In a fictional example, unit and thousand-unit tables show 120 and 0.120. The multiplier explains the difference; no economic change is established.
In-depth practical guides
Identify the structure, codes and attributes of a statistical extract before comparing values.
Updated :

AI-generated illustration
SDMX supports statistical data and metadata exchange. An isolated value does not identify its population, unit or observation status. The producer’s structure explains the codes; a response format cannot replace that reading.
Record agency, flow identifier and structure version. An omitted version may select the latest; retain the structure actually used.
Read dimensions in their documented order and consult code lists. Frequency, territory, unit or adjustment can change a series’ meaning.
Retain unit, multiplier and status at their attachment level. Do not turn missing or provisional observations into final results.
Record full request, filters, period, Accept header, download time and raw file. Compare keys before numbers.
Reading workshop
The DEMO flow and codes are invented. Its contract orders the key as FREQ.REF_AREA.UNIT.ADJ; this order is not universal.
Fictional data and records for learning: none of these results comes from a live service query.
M means monthly, A annual; COUNT counts events, INDEX is an index; NSA is unadjusted, SA seasonally adjusted. Status is an observation attribute retained outside the key.
If the table exceeds the screen, scroll horizontally; arrow keys work when the region is focused.
| Complete DEMO key | Period | Value and status | Permitted comparison |
|---|---|---|---|
| M.DEMO-A.COUNT.NSA | 2026-03 | 80; provisional | Retain this unadjusted monthly observation with its qualification. |
| M.DEMO-A.COUNT.SA | 2026-03 | 78; provisional | Different adjustment: not a temporal fall from 80 to 78. |
| A.DEMO-A.COUNT.NSA | 2026 | 900; estimated | Annual frequency: do not append as another month. |
| M.DEMO-A.INDEX.NSA | 2026-03 | 105; final | Index unit: do not subtract it from an event count. |
Open each proposition to compare its diagnosis. More checks may still be needed.
No. Frequency, unit and adjustment change. Area alone does not identify a series.
No. Both observations concern March; only adjustment differs.
Yes. Select a complete key and obtain compatible periods, retaining each observation’s status.
Flow: DEMO; local structure retained Order: FREQ, REF_AREA, UNIT, ADJ Selected key: M.DEMO-A.COUNT.NSA Period: 2026-03; value: 80 Status: provisional, attribute retained Decision: no temporal change calculated
Period identifies an observation within the series. A provisional attribute does not become final because the key is complete.
In a fictional example, unit and thousand-unit tables show 120 and 0.120. The multiplier explains the difference; no economic change is established.
An illustrative request returns annual and monthly series. Separate keys rather than treating every row as one timeline.
From observation to decision
A fictional index series with unchanged definition and unit is accessed twice. The 1 September 2026 extract reports 100 for 2023 and 104 for 2024. The 1 October extract retains 100 for 2023 but revises 2024 to 106.
Fictional learning case: counts and dates illustrate the method and do not describe a real assignment.
Scale from 0 to 8%. Each bar describes 2023–2024 growth in a different edition.
| Observation | Useful check | Next action |
|---|---|---|
| Extract dated 2026-09-01 | 2023: 100; 2024: 104. | 2023–2024 change: (104 − 100) / 100 = +4%. |
| Extract dated 2026-10-01 | 2023: 100; 2024: 106. | Revised 2023–2024 change: (106 − 100) / 100 = +6%. |
| Same observation periods | The extraction edition changes, not the 2024 period. | Retain series key, structure, unit, attributes and each extraction date. |
The gap from 104 to 106 is 2 index points, about 1.92% relative to 104. It revises the estimate for the same period; it is not new growth between September and October 2026. Read status codes in the producer’s structure rather than assuming universal meanings.
Reference: SDMX organises statistical data and metadata. This case compares fictional extracts, not an official series or code. SDMx — Statistical Data and Metadata
Worked exercise
Fictional example: the values and documents teach the method and do not describe a real organisation.
Monthly frequency, two areas and two measures. Total and adjusted variants are not declared additive.
If the table exceeds the screen, scroll horizontally; arrow keys work when the region is focused.
| Area | Measure | Observations |
|---|---|---|
| A | Total | 12 |
| A | Adjusted | 12 |
| B | Total | 12 |
| B | Adjusted | 12 |
There are 2 × 2 = 4 series and 48 observations, not a 48-month timeline. Separate all four keys. Total and adjusted are measure variants, not categories to sum without a definition allowing it.
Distinguish a nonexistent combination from an existing series with missing observations.
Keep structure, code lists, filters, full keys, attributes and value statuses.
DOCUMENTED REFERENCE
This historical extract fixes 2024, both sexes and two age bands for the EU, Spain, France and Finland. The 40 lfsi_sla_a observations were updated 10 September 2026 and retrieved 22 October 2026. They are annual data, not the latest available quarter. Published values and flags are retained.
| Reference | Value or form | What it identifies |
|---|---|---|
| UNE | Unemployed persons | Unemployed people as a percentage of the extended labour force. This is not the usual unemployment rate, which uses a narrower denominator. |
| UEMP_PT | Underemployed part-time | Underemployed part-time workers wanting and available for more hours under the series definition. They are already in the labour force. |
| SEEK_NAVL | Seeking, unavailable | People seeking work but not immediately available under Eurostat criteria, outside the usual labour force. |
| NSEEK_AVL | Available, not seeking | People available but not seeking work under the series criteria, outside the usual labour force. |
| SLACK | Published total | Eurostat’s published slack total, retained separately from the sum of four rounded component values. |
| PC_ELF | % extended labour force | The denominator adds the two outside groups to employment and unemployment. Do not add underemployed part-time people a second time. |
| d | Definition differs | Definition differs: see metadata. All selected French and Spanish cells carry this flag; the response does not establish the national cause here. |
Retrieved · Response updated .
European Union (27) · 15–74 · 2024
Published total : 11.8 %
Component sum : 11.7 %
Gap: total minus sum (points) : 0.1
| Territory | Age | Unemployment | Underemployed part-time | Seeking, unavailable | Available, not seeking | Published total |
|---|---|---|---|---|---|---|
| European Union (27) | 15–74 | 5.7 | 2.4 | 0.9 | 2.7 | 11.8 |
| European Union (27) | 20–64 | 5.5 | 2.3 | 0.8 | 2.3 | 11.0 |
| France | 15–74 | 7.2 d | 3.7 d | 1.6 d | 2.1 d | 14.7 d |
| France | 20–64 | 6.8 d | 3.7 d | 1.4 d | 1.9 d | 13.7 d |
| Finland | 15–74 | 7.9 | 4.4 | 3.3 | 2.3 | 17.9 |
| Finland | 20–64 | 7.5 | 4.0 | 2.4 | 1.5 | 15.3 |
| Spain | 15–74 | 10.9 d | 4.4 d | 1.0 d | 3.0 d | 19.3 d |
| Spain | 20–64 | 10.6 d | 4.4 d | 1.0 d | 2.8 d | 18.7 d |
d: definition differs; see metadata. The flag accompanies every affected value.
The table retains all 40 observations and flags even without JavaScript. Gaps are not added as a bar category. No flag is not a comparability certificate.
For EU ages 15–74, the published total is 11.8%, while the four one-decimal components sum to 11.7%. The chart displays their sum without stretching it to the total. The gap is shown in points, not a fifth category. Rounded values alone cannot precisely explain every gap.
Its denominator is the extended labour force rather than the labour force alone. Comparing the percentages as equal-base measures creates an artificial difference. Keep PC_ELF and age in the caption.
Documentation consulted on .
DOCUMENTED REFERENCE
In a JSON-stat cube, dimension and category order define the meaning of a flattened value array. The official order.json example contains 24 demonstration cells, not economic observations. The last dimension changes fastest.
| Reference | Value or form | What it identifies |
|---|---|---|
| id | [A, B, C] | Dimension order A, B, C is part of the contract. Alphabetically sorting dimension names can relocate observations in another dataset. |
| size | [3, 2, 4] | Three A categories, two B categories and four C categories give 24 cells, even if a sparse value object lists fewer entries. |
| category.index | 0 … n−1 | Positions start at zero. Category code, display label and position are separate properties. |
| stride | [8, 4, 1] | Strides use subsequent dimension sizes: 2 × 4, then 4, then 1. They are not statistical units. |
| offset | iA × 8 + iB × 4 + iC | Positions (1, 0, 3) produce flattened index 11. Reconstruct this address before pairing value and status. |
| value / status | index | Missing or null is not zero. Status information refers to cells and can also use a compact representation. |
Choose one category per dimension. Positions start at zero; category codes happen to start at 1 here. The table preserves all 24 published values.
A1 · B1 · C1 → index 0 = 0 × 8 + 0 × 4 + 0; published value: A1B1C1.
| Flattened index | Category address | Literal source value |
|---|---|---|
| 0 | A1 · B1 · C1 | A1B1C1 |
| 1 | A1 · B1 · C2 | A1B1C2 |
| 2 | A1 · B1 · C3 | A1B1C3 |
| 3 | A1 · B1 · C4 | A1B1C4 |
| 4 | A1 · B2 · C1 | A1B2C1 |
| 5 | A1 · B2 · C2 | A1B2C2 |
| 6 | A1 · B2 · C3 | A1B2C3 |
| 7 | A1 · B2 · C4 | A1B2C4 |
| 8 | A2 · B1 · C1 | A2B1C1 |
| 9 | A2 · B1 · C2 | A2B1C2 |
| 10 | A2 · B1 · C3 | A2B1C3 |
| 11 | A2 · B1 · C4 | A1B1C4 |
| 12 | A2 · B2 · C1 | A2B2C1 |
| 13 | A2 · B2 · C2 | A2B2C2 |
| 14 | A2 · B2 · C3 | A2B2C3 |
| 15 | A2 · B2 · C4 | A2B2C4 |
| 16 | A3 · B1 · C1 | A3B1C1 |
| 17 | A3 · B1 · C2 | A3B1C2 |
| 18 | A3 · B1 · C3 | A3B1C3 |
| 19 | A3 · B1 · C4 | A3B1C4 |
| 20 | A3 · B2 · C1 | A3B2C1 |
| 21 | A3 · B2 · C2 | A3B2C2 |
| 22 | A3 · B2 · C3 | A3B2C3 |
| 23 | A3 · B2 · C4 | A3B2C4 |
The official file consulted on 2026-10-22 has an illustrative inconsistency: index 11 contains the literal A1B1C4, although its category address is A2, B1, C4. The explorer preserves the source text. A value’s label must not replace dimension metadata.
Documentation consulted on .
An extract linking each observation to its key, unit and status.
No. Their order and meaning come from the flow structure. The same short code can occur in different lists.
It retains values but may omit parameters or metadata. Store the request and relevant structures alongside the file.
Codes stabilize identification and textbooks make it easier to read. Their dictionary and its version enable you to understand the categories and to find out the series despite an evolution of presentation.
TOOLS / REGISTERS
Record full request, filters, period, Accept header, download time and raw file. Compare keys before numbers.
DOCUMENTED REFERENCE
Eurostat’s S_ADJ response checked on 22 October 2026 distinguishes six categories. In the diagram S means seasonal and C calendar adjustment: 1 present, 0 absent. The code describes treatment, not overall series quality.
| Reference | Value or form | What it identifies |
|---|---|---|
| NSA | S=0 · C=0 | Unadjusted: neither seasonal nor calendar adjustment. Preserve the status when comparing with adjusted results. |
| SA | S=1 · C=0 | Seasonally adjusted but not calendar adjusted in this list. Do not expand SA to mean every seasonal and calendar effect removed. |
| CA | S=0 · C=1 | Calendar adjusted but not seasonally adjusted. Working-day treatment does not imply all recurring annual variation is removed. |
| SCA | S=1 · C=1 | Both seasonal and calendar adjustment. Still check method, period, model and data vintage across producers. |
| TC | TC | Trend-cycle component, not a raw observation or forecast. Recent points can change as information and methods evolve. |
| NAP | NAP | Adjustment not applicable. Neither measured zero nor an automatic synonym of NSA. |
Compare identical categories and retain raw series when available. Re-estimated seasonal factors may revise earlier periods without raw measurements changing. Monthly adjusted and annual unadjusted rates do not share the same treatment.
Keep its value in the record and chart metadata. Removing every trace makes differences between extracts of the same variable and period harder to understand.
Documentation consulted on .
DOCUMENTED REFERENCE
These nine observations cover three selected dates in 2025 and three currencies. Extracted on 22 October 2026, this sample is fixed: it is neither a current quote, an annual average nor every day of 2025.
Rates are currency units per euro. Divide a foreign-currency amount by the rate to obtain euros; multiply in the other direction. This calculation does not adjust inflation or include exchange fees or margins.
Fixed extract, consulted on .
| Observation date | USD/EUR | GBP/EUR | JPY/EUR |
|---|---|---|---|
| 1.0321 | 0.83118 | 162.04 | |
| 1.1419 | 0.8434 | 162.98 | |
| 1.175 | 0.8726 | 184.09 |
Method: M in currency ÷ T in currency/EUR = M/T in EUR. Reverse: M in EUR × T = M×T in currency.
Use a dot or comma as the decimal separator and spaces for thousands. Negative amounts are accepted to examine a correction.
1 000.00 USD gives 968.90 EUR. Observation on 2025-01-02: 1 EUR = 1.0321 USD.
Arithmetic illustration: the entered amount is an exercise, not observed expenditure. Results use two decimal places; calculations use the stored rate. The ECB publishes reference rates for information and discourages their use for transactions.
Frequency D: daily. Three separate dates, no interpolation of missing days. Quote is currency per EUR, with unit multiplier 0 in the responses. All nine values retain source precision; derived calculations are not additional official rates.
Source: European Central Bank. Nine observations reproduced unchanged; conversions and presentation calculated by this site. The data are also freely available from the ECB.
DEEPER READING / PRACTICE
A SDMX response contains values, dimensions and attributes. Reading must reconstruct the meaning of each observation before presenting it as a chronological series.
Updated on .
Identify structure, codes, frequency, unit and attributes. Check the filters and keep the constant dimensions that define the extracted series.
A single value is not enough to know territory, unit or status. A filter change can select a different series without changing the name presented.
The extraction sheet retains query, dimensions, dictionaries and dates. The values are accompanied by the attributes necessary for their interpretation.