{"id":2765,"date":"2023-11-10T18:48:20","date_gmt":"2023-11-10T17:48:20","guid":{"rendered":"https:\/\/www.istat.it\/?page_id=2765"},"modified":"2025-10-13T12:03:09","modified_gmt":"2025-10-13T10:03:09","slug":"sdmx-web-services","status":"publish","type":"page","link":"https:\/\/www.istat.it\/en\/classifications-and-tools\/sdmx-web-services\/","title":{"rendered":"SDMX Web Services"},"content":{"rendered":"\n<p><strong>Starting from July 2022<\/strong>, Istat will progressively display its data through a new dissemination system, the&nbsp;<a href=\"https:\/\/esploradati.istat.it\/databrowser\/#\/en\">IstatData<\/a>, natively based on SDMX-RI. This system will guarantee better usability of data, thanks to dashboards, graphs, customizable layouts and filterable datasets.<\/p>\n\n\n\n<p>The relative diffusion in<strong>&nbsp;machine-to-machine<\/strong>&nbsp;mode will take place through following End-Point:&nbsp;<a href=\"https:\/\/esploradati.istat.it\/SDMXWS\">https:\/\/esploradati.istat.it\/SDMXWS<\/a><\/p>\n\n\n\n<p>To prevent <a href=\"https:\/\/esploradati.istat.it\/SDMXWS\">SDMX web service <\/a>overloading, a limit of 5 queries per minute has been\u00a0set\u00a0for each IP. Once this limit is exceeded, an access block lasting between 1 and 2 days is activated.<\/p>\n\n\n\n<p><\/p>\n\n\n\n<p>.<\/p>\n\n\n\n<p><strong>In order to ensure the display continuity of the data acquired through the webservice, users are advised to modify their SDMX queries by the end of 2022.<\/strong><\/p>\n\n\n\n<p>New web service will maintain compatibility with the previous one for most of the artifacts used; codelist and dataflow will remain unchanged.<\/p>\n\n\n\n<p>However, users will have to consider the following small differences:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Query REST: for some dataflows the position of the dimensions will change (in the corresponding DSD).<\/li>\n\n\n\n<li>Query SOAP: for some dataflows the name of the dimensions will change (in the corresponding DSD).<\/li>\n<\/ul>\n\n\n\n<p>To facilitate queries conversion, Istat provides a simple&nbsp;<a href=\"https:\/\/www.istat.it\/wp-content\/uploads\/2024\/04\/Convertitore-Query-SEP-1.7.xlsm\">excel tool<\/a>&nbsp;that will allow users:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Automatically modify the REST queries on new environment, starting from queries prepared for the old webservice (single query tool, multiple query tool).<\/li>\n\n\n\n<li>Compare names of dimensions on the two environments, starting from the dataflow (tool for dataflow search and dimension transcoding).<\/li>\n<\/ul>\n\n\n<section class=\"gblock accordion_livelli white-bg  py-0\"  aria-labelledby=\"section-1\"><div class=\"container p-lg-0 block_count_1\" data-blockcount=\"1\"><div class=\"row pb-2\">\t\t<div class=\"accordion bianco\" id=\"accordion_1liv_0_block_01c20d870829f1645070e9e9d7a31663\">\r\n\t\t\t\t\t\t\t<div class=\"accordion-item liv1\">\r\n\t\t\t\t\t\t\t\t\t\t\t<h2 class=\"accordion-header\">\r\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<button class=\"accordion-button collapsed\" type=\"button\" \r\n\t\t\t\t\t\t\t\tdata-bs-toggle=\"collapse\" data-bs-target=\"#collapse_al_1_1liv_block_01c20d870829f1645070e9e9d7a31663\" aria-expanded=\"false\" aria-controls=\"collapse_al_1_1liv_block_01c20d870829f1645070e9e9d7a31663\">\r\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\tEndpoint for data access\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/button>\r\n\t\t\t\t\t\t\t\t\t\t\t\t\t<\/h2>\r\n\t\t\t\t\t\t\t\t\t\t<div id=\"collapse_al_1_1liv_block_01c20d870829f1645070e9e9d7a31663\" class=\"accordion-collapse collapse\" \r\n\t\t\t\t\t\tdata-row=\"0\" \r\n\t\t\t\t\t\tdata-depth=\"1\" \r\n\t\t\t\t\t\t\t\t\t\t\t\tdata-bs-parent=\"#accordion_1liv_0_block_01c20d870829f1645070e9e9d7a31663\">\r\n                        <div class=\"row\">\r\n                                                            <div class=\"accordion-body col-12\">\r\n                                    <p>For each of the following\u00a0<strong>Root URL<\/strong><\/p>\n<ul class=\"lista\">\n<li><a href=\"https:\/\/esploradati.istat.it\/SDMXWS\">Main database (new web service)<\/a><\/li>\n<li><a href=\"http:\/\/sdmx.istat.it\/SDMXWS\/\">Main database (old web service)<\/a><\/li>\n<li><a href=\"http:\/\/sdmx.istat.it\/WS_CENSAGR\/\">Agricultural census 2010<\/a>:<\/li>\n<li><a href=\"http:\/\/sdmx.istat.it\/WS_CENSPOP\/\">Population and housing census 2011<\/a><\/li>\n<li><a href=\"http:\/\/sdmx.istat.it\/WS_CIS\/\">Industry and services census 2011<\/a><\/li>\n<\/ul>\n<p>the following five\u00a0<strong>Endpoints\u00a0<\/strong>are available<\/p>\n<ul class=\"lista\">\n<li>Standard SDMX v2.0<\/li>\n<li>SDMX v2.0 with Eurostat extensions<\/li>\n<li>Standard SDMX v2.0 (No extra element)<\/li>\n<li>Standard SDMX v2.0 with Eurostat extensions (No extra element)<\/li>\n<li>Standard SDMX v2.1<\/li>\n<\/ul>\n                                <\/div>\r\n                                                                                <\/div>\r\n                        \t\t\t\t\t<\/div>\r\n\t\t\t\t<\/div>\r\n\t\t\t\t\t\t\t<div class=\"accordion-item liv1\">\r\n\t\t\t\t\t\t\t\t\t\t\t<h2 class=\"accordion-header\">\r\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<button class=\"accordion-button collapsed\" type=\"button\" \r\n\t\t\t\t\t\t\t\tdata-bs-toggle=\"collapse\" data-bs-target=\"#collapse_al_2_1liv_block_01c20d870829f1645070e9e9d7a31663\" aria-expanded=\"false\" aria-controls=\"collapse_al_2_1liv_block_01c20d870829f1645070e9e9d7a31663\">\r\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\tExcel Tool\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/button>\r\n\t\t\t\t\t\t\t\t\t\t\t\t\t<\/h2>\r\n\t\t\t\t\t\t\t\t\t\t<div id=\"collapse_al_2_1liv_block_01c20d870829f1645070e9e9d7a31663\" class=\"accordion-collapse collapse\" \r\n\t\t\t\t\t\tdata-row=\"0\" \r\n\t\t\t\t\t\tdata-depth=\"1\" \r\n\t\t\t\t\t\t\t\t\t\t\t\tdata-bs-parent=\"#accordion_1liv_0_block_01c20d870829f1645070e9e9d7a31663\">\r\n                        <div class=\"row\">\r\n                                                            <div class=\"accordion-body col-12\">\r\n                                    <p><a href=\"https:\/\/www.istat.it\/wp-content\/uploads\/2024\/04\/Convertitore-Query-SEP-1.7.xlsm\">Excel tool for the queries conversion<\/a>\u00a0(xlsm) for the use on new webservice<\/p>\n                                <\/div>\r\n                                                                                <\/div>\r\n                        \t\t\t\t\t<\/div>\r\n\t\t\t\t<\/div>\r\n\t\t\t\t\t\t\t<div class=\"accordion-item liv1\">\r\n\t\t\t\t\t\t\t\t\t\t\t<h2 class=\"accordion-header\">\r\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<button class=\"accordion-button collapsed\" type=\"button\" \r\n\t\t\t\t\t\t\t\tdata-bs-toggle=\"collapse\" data-bs-target=\"#collapse_al_3_1liv_block_01c20d870829f1645070e9e9d7a31663\" aria-expanded=\"false\" aria-controls=\"collapse_al_3_1liv_block_01c20d870829f1645070e9e9d7a31663\">\r\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\tFAQ\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/button>\r\n\t\t\t\t\t\t\t\t\t\t\t\t\t<\/h2>\r\n\t\t\t\t\t\t\t\t\t\t<div id=\"collapse_al_3_1liv_block_01c20d870829f1645070e9e9d7a31663\" class=\"accordion-collapse collapse\" \r\n\t\t\t\t\t\tdata-row=\"0\" \r\n\t\t\t\t\t\tdata-depth=\"1\" \r\n\t\t\t\t\t\t\t\t\t\t\t\tdata-bs-parent=\"#accordion_1liv_0_block_01c20d870829f1645070e9e9d7a31663\">\r\n                        <div class=\"row\">\r\n                                                            <div class=\"accordion-body col-12\">\r\n                                    <p><strong>What basic IT equipment you need to access data dissemination service via web service?<\/strong><br \/>\nYou need an internet connection and a device for its use.<\/p>\n<p><strong>Which operating system must the computers that access the data dissemination service via web service have?<\/strong><br \/>\nOperating system and software application environment of machines that connect, does not affect the query web service.<\/p>\n<p><strong>Is access to data dissemination service via web service free?<\/strong><br \/>\nYes. Access to data dissemination service via web service is free<\/p>\n<p><strong>How can I query web service?<\/strong><br \/>\nYou can webservice via SOAP queries or via REST queries. You can built applications in all software development environments that support the definition of objects for connecting to web service.<br \/>\nIt is also possible to submit queries to data dissemination web service using any web debugger or using client tools made available by Eurostat in its SDMX Reference Infrastructure.<\/p>\n<p><strong>Where can I find SDMX documentation?<\/strong><br \/>\nOn\u00a0<a href=\"http:\/\/sdmx.org\/\">http:\/\/sdmx.org<\/a>\u00a0or on Eurostat\u00a0<a href=\"https:\/\/webgate.ec.europa.eu\/fpfis\/mwikis\/sdmx\/index.php\/Main_Page\">SDMX Infospace<\/a>.<\/p>\n<p><strong>Where can I find SDMX Istat API documentation?<\/strong><br \/>\nOn\u00a0<a href=\"https:\/\/developers.italia.it\/it\/api\/istat-sdmx-rest.html\">https:\/\/developers.italia.it\/it\/api\/istat-sdmx-rest.html<\/a><\/p>\n                                <\/div>\r\n                                                                                <\/div>\r\n                        \t\t\t\t\t<\/div>\r\n\t\t\t\t<\/div>\r\n\t\t\t\t\t<\/div>\r\n\t<\/div><\/div><\/section>","protected":false},"excerpt":{"rendered":"<p>Through the standard SDMX protocol (Statistical Data and Metadata eXchange), Istat disseminates data of the corporate data warehouse (I.Stat) also in machine-to-machine mode via web service.<\/p>\n","protected":false},"author":6,"featured_media":8388,"parent":2266,"menu_order":18,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"footnotes":""},"class_list":["post-2765","page","type-page","status-publish","has-post-thumbnail","hentry"],"acf":[],"wpml_current_locale":"en_US","wpml_translations":[],"_links":{"self":[{"href":"https:\/\/www.istat.it\/en\/wp-json\/wp\/v2\/pages\/2765","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.istat.it\/en\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.istat.it\/en\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.istat.it\/en\/wp-json\/wp\/v2\/users\/6"}],"replies":[{"embeddable":true,"href":"https:\/\/www.istat.it\/en\/wp-json\/wp\/v2\/comments?post=2765"}],"version-history":[{"count":9,"href":"https:\/\/www.istat.it\/en\/wp-json\/wp\/v2\/pages\/2765\/revisions"}],"predecessor-version":[{"id":107016,"href":"https:\/\/www.istat.it\/en\/wp-json\/wp\/v2\/pages\/2765\/revisions\/107016"}],"up":[{"embeddable":true,"href":"https:\/\/www.istat.it\/en\/wp-json\/wp\/v2\/pages\/2266"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.istat.it\/en\/wp-json\/wp\/v2\/media\/8388"}],"wp:attachment":[{"href":"https:\/\/www.istat.it\/en\/wp-json\/wp\/v2\/media?parent=2765"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}