Portal API GUS

General information Registration Manual Contact Statistics

General information

The TERYT web service ws1 that makes the data available from the TERYT register to public administration entities and commercial entities. Service and data are available free of charge. The file sharing format is xml.

The following catalogs are available:

identifiers and names of territorial division units (TERC),
identifiers and names of localities (SIMC),
The Central Catalogue of Streets (ULIC),
a set of definitions for the types of localities WMRODZ and
Nomenclature of Territorial Units for Statistical Purposes (NTS).

Dataset on NTS includes data for the period from 27 July 2000 to 1 January 2017. From 1 January 2018, a new Coding System of Territorial and Statistical Units (KTS) has been in force. For more information on NTS and KTS, please visit: https://stat.gov.pl/en/regional-statistics/classification-of-territorial-units/the-coding-system-for-territorial-and-statistical-units-kts/.

The TERYT service ws1 provides users methods that perform the following functionalities:

downloading units of territorial division, localities and streets (full files),
downloading information about changes in the registry created in a given period of time (updating files),
downloading a specific range of data about territorial division units - list of objects,
verification of address data to the street level,
searching for units of territorial division, localities and streets.

Verification of address data to the street level applies only to the current status of the TERYT database and is based on names or identifiers.

In order to meet the requirement set out in §8 point 3 of the Regulation of the Minister of Economic Development, Labour and Technology of 21 July 2021 on the Localities, Streets and Addresses Register (Journal of Laws of 2021, item 1368), as part of the TERYT ws1 service a new functionality for gminas has been launched. It enables receiving by statistics services electronically sent information on changes in street naming and ordinal numbering of buildings from the Localities, Streets and Addresses Register (EMUiA).

Registration

In order to use the service, please send an email to teryt_ws1@stat.gov.pl, providing the following information:

User Name
Contact phone number
Contact e-mail adress
Commercial entity / Public administration / Private individual

Feedback will be sent to the user after the account is created.

For the module dedicated to gminas:

Name of the gmina and its TERC identifier
Contact phone numer
Contact e-mail address
Name and address of the institution requesting access to the service

A similar scope of information should be sent to the competent Statistical Office due to the location (voivodship) in order to identify and certify the account in the service. Feedback on the possibility of using the service will be sent via e-mail on address indicated in the application. Login data will be provided separately.

Manual

The following documentation contains all the information necessary to integrate with the service TERYT and a module for gminas:

ZIP Technical manual of TERYT ws1 service

ZIP Technical manual of TERYT ws1 service – suplement for gminas

Contact

Reports of Failures or Problems should be made via e-mail or telephone.

By phone, at 42 683-90-67
To the email address: teryt_support@stat.gov.pl

The content of the notification should specify whether it concerns a problem/failure, TERYT service/module for gminas, name and surname and landline telephone number of the contact person.

Statistics

193 663 592 queries from 01.01.2015

4 195 registered users

The daily use of the service - last 7 days