PNA API (Postal Code API)
# 📬 PNA (Postal Codes) API Documentation **[EN]** High-performance API for searching Polish Postal Codes (PNA), validating addresses, and autocomplete suggestions. Optimized for precise house number matching (ranges, odd/even logic). **[PL]** Wysokowydajne API do wyszukiwania kodów pocztowych (PNA), weryfikacji adresów i autouzupełniania. Zoptymalizowane pod kątem precyzyjnego dopasowania…
PNA API (Postal Code API) endpoints
| Method | Endpoint | Description |
|---|---|---|
| PNA (Postal Codes) API | ||
| GET |
GetAddressesByPostalCode /pna/code/{postalCode} |
Retrieves all streets and address ranges assigned to a specific Postal Code (Format: XX-XXX). |
| GET |
SearchPostalCodeByAddress /pna/search |
Finds Postal Codes (PNA) based on address details like City, Street, and Number. Returns detailed address info including number ranges. |
| POST |
SearchPostalCodeByAddressPost /pna/search |
Finds Postal Codes using a JSON object. Preferred for complex queries or when integrating with systems that support structured bodies. |
| POST |
GetAddressesByPostalCodePost /pna/code |
Retrieves addresses for a Postal Code sent in JSON body. Useful for clients enforcing POST for data retrieval. |
| Reverse Geocoding | ||
| GET |
ReverseGeocodingGet /pna/reverse |
Finds the closest Postal Codes (PNA) for given GPS coordinates. Returns addresses sorted by distance. |
| POST |
ReverseGeocodingPost /pna/reverse |
Finds Postal Codes by GPS coordinates sent in JSON body. |
| Autocomplete | ||
| GET |
AutocompleteCities /pna/autocomplete/cities |
Provides real-time city name suggestions based on partial input. |
| GET |
AutocompleteStreets /pna/autocomplete/streets |
Provides real-time street name suggestions based on partial input. Can be filtered by City. |
| AI Configuration | ||
| GET |
/pna/ai-guide /pna/ai-guide |
|
| GET |
/pna/.well-known/ai-plugin.json /pna/.well-known/ai-plugin.json |
|
PNA API (Postal Code API) pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | $5 / month | 1 / second |
|
| ULTRA Recommended | $12 / month | 2 / second |
|
| MEGA | $24 / month | 4 / second |
|