# teryt24.pl

> Free REST API for Polish registry & geo data: cities and localities
> (GUS TERYT SIMC), streets (ULIC), postal codes (PNA) and address
> validation (GUGiK PRG). Keyless calls are rate-limited to 60
> requests/min/IP; responses are JSON, CORS is open and format=geojson
> answers RFC 7946 FeatureCollections.

## Docs

- [API reference (interactive)](https://teryt24.pl/docs): the OpenAPI document rendered with Scalar
- [Integration guide](https://teryt24.pl/docs/guide): step-by-step recipes in curl, Python and JavaScript — autocomplete forms, address validation, postal codes, GeoJSON maps
- [Change-feed webhooks](https://teryt24.pl/docs/webhooks): push events for TERYT changes (operator-created subscriptions — event schema, the HMAC signature recipe, the retry schedule)
- [openapi.json](https://teryt24.pl/openapi.json): the machine-readable OpenAPI 3.1 spec
- [Usage policy](https://teryt24.pl/usage-policy): rate limits, identification, attribution, prohibited uses
- [Sitemap](https://teryt24.pl/sitemap.xml): sitemap index of the HTML pages

## Endpoint reference pages

Server-rendered, script-free reference for every endpoint family:

- [Geocoding & address validation (GET /v1/geocode, POST /v1/geocode/batch)](https://teryt24.pl/docs/geocode)
- [Address validation workflow (GET /v1/validate) — structured address, match kinds, verdict and issues](https://teryt24.pl/docs/validate)
- [Bulk address normalisation (POST /v1/bulk/addresses, GET /v1/bulk/jobs/{id}, GET /v1/bulk/jobs/{id}/result.csv) — CSV upload, background job, result file](https://teryt24.pl/docs/bulk)
- [TERYT change feed (GET /v1/changes) — additions, modifications, moves, renames, orderings and deletions, with the catalogue states](https://teryt24.pl/docs/changes)
- [Postal codes (GET /v1/postal-codes, GET /v1/postal-codes/{code}, POST /v1/postal-codes/bulk)](https://teryt24.pl/docs/postal-codes)
- [Localities (GET /v1/localities, GET /v1/localities/{sym})](https://teryt24.pl/docs/localities)
- [Unified autocomplete (GET /v1/autosuggest)](https://teryt24.pl/docs/autosuggest)
- [Streets (GET /v1/streets, GET /v1/streets/{symUl})](https://teryt24.pl/docs/streets)
- [Reverse geocoding (GET /v1/reverse-geocode)](https://teryt24.pl/docs/reverse-geocode)
- [Administrative hierarchy (GET /v1/regions, /v1/regions/{code}/counties, /v1/regions/{code}/municipalities) and the voivodeship's demographic decomposition (GET /v1/regions/{code}/demography)](https://teryt24.pl/docs/regions)
- [Administrative boundaries as RFC 7946 WGS84 GeoJSON, keyed by TERC (GET /v1/boundaries/counties — the 380 counties, GET /v1/boundaries/regions — the 16 voivodeships), with the label point per feature](https://teryt24.pl/docs/boundaries)
- [Rate limits & identification (GET /v1/whoami, GET /v1/usage; X-API-Key header)](https://teryt24.pl/docs/limits)

English mirrors of every page above live under https://teryt24.pl/en/docs/….