Generator · Polish data
Polish address
Endpoint GET /v1/pl/address
What it covers
Returns a realistic Polish address drawn from real cities and streets. Narrow the location with a `teryt` prefix (1–7 digits). By default the address comes from a curated, frozen catalogue, so a given `seed` keeps returning the same address; pass `live=true` to draw from the full, current PRG register instead.
Parameters
| Parameter | Type | Description |
|---|---|---|
| count | integer1–10000 | Number of records to return, 1–10000. Omitted returns a single record; set it for a batch. Costs 1 token plus a tenth per record. |
| edge | boolean | Restrict output to edge-case addresses (street-less localities, awkward names/numbers). |
| extreme | boolean | Return a correct address whose text fields (streetFullName, buildingNumber, postalCode, cityName) are wrapped in a hostile encoding (untrimmed whitespace, invisible/zero-width characters, BOM, homoglyph letters, or bidi/combining marks). Administrative names and TERYT codes stay clean. |
| invalid | boolean | Return a deliberately invalid value that fails validation, for testing rejection paths. |
| live | boolean | Draw from the full, current PRG register instead of the curated catalogue. The catalogue (default) is a frozen extract — ~9,300 places, ~25,000 streets, all 2,479 gminas — so a given seed keeps returning the same address indefinitely. `live=true` covers every place in Poland and tracks what GUGiK publishes, but the underlying data changes, so a seed is not guaranteed to reproduce across releases. Addresses are real either way. |
| seed | integer | Integer seed for reproducible output: the same seed always yields the same record. |
| teryt | stringpattern ^\d{1,7}$ | Restrict output to a region by TERYT prefix (1–7 digits). |
Response fields
| Field | Type | Description |
|---|---|---|
| streetFullName? | string | |
| buildingNumber | string | |
| postalCode | string | |
| cityName | string | |
| municipalityName | string | |
| countyName | string | |
| voivodeshipName | string | |
| terytCodes | object |
Other generators for Poland
Polish companyPolish company namePolish driving licence numberPolish email addressPolish IBANPolish ID card numberPolish KRS numberPolish land and mortgage register numberPolish NIPPolish passport numberPolish personPolish person namePolish PESELPolish product or service offeringPolish REGONPolish vehicle registration plate
See all generators for Poland →Try it