Postal Codes

Endpoints for postal codes and administrative groupings.

GET/postal-codes
GET/postal-codes/by-wojewodztwo/:slug
GET/postal-codes/by-powiat/:id
GET/postal-codes/by-gmina/:id
GET/postal-codes/:id

List parameters

ParameterTypeRequiredDefaultDescription
qstringNo-Postal code or text filter.
limitnumberNo100Maximum number of records.
offsetnumberNo0Number of records to skip.
sortenumNocodeOne of `code`, `address_count`, `city_count`, `gmina_count`.
directionenumNoascOne of `asc`, `desc`.

Grouping parameters

ParameterTypeRequiredDefaultDescription
slugstringYes-Wojewodztwo slug for `/by-wojewodztwo`.
idnumberYes-Numeric powiat or gmina id for grouped routes.
limitnumberNo600Maximum number of records.
offsetnumberNo0Number of records to skip.
sortenumNocodeOne of `code`, `address_count`, `city_count`, `gmina_count`.
directionenumNoascOne of `asc`, `desc`.

/postal-codes/:id accepts an internal numeric id or a postal code value. The postal code hyphen is optional.