📘 Documentation 📥 Datasets 🛠️ Postal Tools

Postal Code REST API, Reverse Geocoding & JSON Lookup

Integrate real-time postal code autocomplete, WGS84 reverse geocoding, geodesic distance calculation, and UPU S42 address validation into your applications.

⚡ Interactive Live API Playground (Click to Test)

GET https://postalcodes.info/search?q=Madrid&format=json

Global & country-scoped autocomplete lookup for postal codes, cities, and streets.

GET https://postalcodes.info/api/v1/geo/reverse?lat=40.4168&lon=-3.7038

Reverse geocoding from WGS84 coordinates to nearest postal code & administrative hierarchy.

GET https://postalcodes.info/api/v1/distance?c1=ES&z1=28001&c2=ES&z2=08001&radius=25

Geodesic Haversine distance, bearing, transit estimate, and nearby postal codes within radius.

// Click any "▶ Test Endpoint Live" button above to inspect the live JSON response...

COMMERCIAL DATA & ENTERPRISE API LICENSING

Commercial Postal Code Datasets & High-SLA API Plans

Production-ready UTF-8 CSV, GeoJSON & Excel exports preserving leading zeros, WGS84 centroids, 3-tier admin hierarchy, UPU S42 regex rules, and commercial redistribution rights — without attribution requirements.

OPEN SAMPLE (ODbL)

Community Sample

0 € with link attribution

✓ Web lookup & sample preview rows
✓ 100 req/day public JSON testing
🔗 Requires visible HTML link to Postalcodes.info

Copy Required Attribution Link

GLOBAL ENTERPRISE EDITION

All 249 Countries B2B DB

119 € one-time · 1,827,156 records + 4 quarterly updates

✓ Complete 249-country normalized database dump
✓ 4 quarterly updates + SQL/Parquet import scripts
✓ Internal SaaS, ERP, logistics & AI training license

PRODUCTION SLA API

Developer & Checkout Pro API

19 € / month · 100,000 requests SLA

✓ 100,000 monthly lookups, reverse geocode & distance
✓ Dedicated API key without IP rate-limit throttling
✓ Sub-30ms edge JSON + commercial checkout license

🔗 Free Sample Attribution & Citation Snippet (1-Click Copy)

Using our free sample or public endpoints in an article, repository, academic study, or app? Copy this verified citation snippet:

<a href="https://postalcodes.info/api" rel="noopener">Data source: Postal Code &amp; Geocode REST API — Postalcodes.info</a>

Frequently Asked Questions: Postal Code & Geocode REST API

How do I query the search endpoint in JSON format?

Send a GET request to /search?q={query}&format=json (or include Accept: application/json). It returns matching countries, cities, and postal codes with canonical URLs in under 30ms.

Does the API support reverse geocoding from GPS coordinates?

Yes. Call GET /api/v1/geo/reverse?lat={latitude}&lon={longitude} to retrieve the nearest verified postal code, locality, administrative hierarchy, and distance in kilometers.

Can I calculate the distance between two postal codes via API?

Yes. Call GET /api/v1/distance?c1=ES&z1=28001&c2=ES&z2=08001 to obtain the Haversine distance in km/miles, compass bearing, and estimated mail transit times.