Estonia Statistics Table Query
estonia-statistics.series.table_queryRead-onlyIdempotent
Run a statistical query against an Estonia statistics table — specify dimension filters to slice data by year and indicator. Returns JSON-stat2 format with labeled dimensions and numeric values. Call estonia-statistics.table_metadata first to discover valid dimension codes and value codes (often Estonian words, e.g. 'Aasta' for year). Example: births/deaths/natural increase (Näitaja='1','2','3'), most recent year (Aasta filter='top' values=['1']). Data: andmed.stat.ee, no auth required, CC BY-SA 4.0 (Statistics Estonia).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Array of dimension filters. Each filter selects which values to include for one dimension. Example: [{code:'Aasta',selection:{filter:'top',values:['3']}}, {code:'Näitaja',selection:{filter:'item',values:['1','2','3']}}]. Response is JSON-stat2 format with dimension labels and numeric values array. | |
| table_path | Yes | Full path to the leaf table to query — same as estonia-statistics.table_metadata table_path. Example: 'rahvastik/rahvastikunaitajad-ja-koosseis/demograafilised-pehinaitajad/RV030.PX'. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present only when the call failed. Includes error code, message, request_id, and any provider-specific extras. | |
| result | No | Tool response payload. Shape varies per tool — consult the tool description and inputSchema. May be an object, array, string, or number depending on the upstream provider response. |