Darmowe API pozwalające pobrać adres przy użyciu kodu pocztowego Poczty Polskiej.
application/json - format JSON (domyślny format)application/xml - format XMLtext/plain - format tekstowy
curl -H 'Accept:application/json' 'https://kodpocztowy.intami.pl/api/KOD'
W miejsce KOD wpisz kod pocztowy w formacie xx-xxx.
Ustaw nagłówek Accept na wybrany format odpowiedzi.
W odpowiedzi zwrócone zostaną informacje opisane w opis pól w wybranym formacie.
curl -H 'Accept:application/json' 'https://kodpocztowy.intami.pl/api/01-111'
curl -H 'Accept:application/json' 'https://kodpocztowy.intami.pl/city/MIASTO'
W miejsce MIASTO wpisz nazwę miasta.
Ustaw nagłówek Accept na wybrany format odpowiedzi.
W odpowiedzi zwrócona zostanie lista kodów pocztowych przypisanych do miasta.
Uwaga: Jeśli istnieje więcej niż jedno miasto o tej nazwie to zostaną zwrócne kody ze wszystkich miast.
curl -H 'Accept:application/json' 'http://kodpocztowy.intami.pl/city/Wrocław'
curl -H 'Accept:application/json' 'https://kodpocztowy.intami.pl/city/MIASTO/district/DZIELNICA'
W miejsce MIASTO wpisz nazwę miasta, a w miejsce DZIELNICA nazwę dzielnicy.
Ustaw nagłówek Accept na wybrany format odpowiedzi.
W odpowiedzi zwrócona zostanie lista kodów pocztowych przypisanych do dzielnicy miasta.
curl -H 'Accept:application/json' 'https://kodpocztowy.intami.pl/city/Wrocław/district/Oporów'
curl -H 'Accept:application/json' 'https://kodpocztowy.intami.pl/city/MIASTO/street/ULICA'
W miejsce MIASTO wpisz nazwę miasta, a w miejsce ULICA nazwę ulicy.
Ustaw nagłówek Accept na wybrany format odpowiedzi.
W odpowiedzi zwrócona zostanie lista kodów pocztowych przypisanych do ulicy w tym miescie.
curl -H 'Accept:application/json' 'https://kodpocztowy.intami.pl/city/Wrocław/street/Grodzka'
| nazwa pola | opis | wymagalność |
|---|---|---|
| Kod | kod pocztowy w formacie xxx-xxx | zawsze |
| Nazwa | nazwa jednostki | występuje dla jednostek, którym przydzielono indywidualny kod pocztowy |
| Miejscowość | nazwa miejscowości | zawsze |
| Ulica | ulica | opcjonalnie |
| Numer | numer budynku | występuje dla jednostek, którym przydzielono indywidualny kod pocztowy |
| Numeracja | opis numeracji | opcjonalnie |
| Gmina | gmina | zawsze |
| Powiat | powiat | zawsze |
| Dzielnica | dzielnica miasta | opcjonalnie |
API udostępnia także endpoint MCP (Model Context Protocol), dzięki czemu modele językowe / LLMy mogą samodzielnie wyszukiwać informacje o polskich kodach pocztowych.
https://kodpocztowy.intami.pl/mcp
Endpoint używa transportu streamable HTTP i nie wymaga uwierzytelnienia.
| nazwa | opis |
|---|---|
lookup_by_zip | zwraca pełny adres dla podanego kodu pocztowego |
lookup_by_city | zwraca listę kodów pocztowych dla miasta |
lookup_by_city_street | zwraca kody pocztowe dla ulicy w mieście (opcjonalnie wildcard) |
lookup_by_city_district | zwraca kody pocztowe dla dzielnicy w mieście |
{
"mcpServers": {
"kody-pocztowe": {
"type": "http",
"url": "https://kodpocztowy.intami.pl/mcp"
}
}
}Endpoint MCP podlega tym samym limitom co reszta API: 50 zapytań na dobę z jednego adresu IP dla planu darmowego. Po przekroczeniu limitu wywołania narzędzi kończą się kodem HTTP 429.
Ilość zapytań z jednego adresu IP jest ograniczona do 50 zapytań na dobę.
W przypadku przekroczenia tego limitu usługa odpowie kodem http 429 - "Too Many Requests".
Jeśli Twoja aplikacja potrzebuje zwiększonego limitu możesz skorzystać z jednego z płatnych planów dostępnych za pośrednictwem
.
Sprawdź dostępne plany subskrypcji.
Jeśli uważasz, że brakuje jakieś funkcjonalości lub potrzebujesz pomocy napisz email.
