Geodash API

Publiczne REST API dla danych administracyjnych Polski. API udostepnia wojewodztwa, powiaty, gminy, miejscowosci, ulice, kody pocztowe, wyszukiwanie tekstowe i reverse lookup po wspolrzednych.

Base URL

GEThttps://api.geodash.pl/api/v1

All endpoint paths in this documentation are relative to this base URL.

bash
curl https://api.geodash.pl/api/v1/health

First request

GET/wojewodztwa

Returns Polish voivodeships with pagination metadata.

bash
curl "https://api.geodash.pl/api/v1/wojewodztwa?limit=16"
js
const response = await fetch('https://api.geodash.pl/api/v1/wojewodztwa?limit=16')
const result = await response.json()

Capabilities

  • No authentication is required for public read endpoints.
  • Responses are JSON.
  • List endpoints use limit and offset pagination.
  • Geometry is optional on administrative endpoints.
  • Search and locate endpoints support text lookup and coordinate lookup.

Common use cases

  • Find a region by name or TERYT identifier.
  • Browse wojewodztwo -> powiat -> gmina.
  • Search city, street or postal code data.
  • Locate coordinates inside Polish administrative units.
  • Download postal code groupings by wojewodztwo, powiat or gmina.