World Postal Codes
Global Address Intelligence for Modern Apps The World Postal Codes API is a high-performance geolocation engine designed for e-commerce, logistics, and data enrichment. With a massive repository of over 1,826,595 records, this API provides instantaneous results with 99.9% accuracy. 🚀 Key Features 🌍 Universal Coverage: Complete postal data for 250+ countries and territories. 📍 IP-to-Postal…
World Postal Codes endpoints
| Method | Endpoint | Description |
|---|---|---|
| health | ||
| GET |
/health /health |
Heartbeat endpoint for monitoring service uptime. |
| v1 | ||
| GET |
/v1/geo/ip /v1/geo/ip |
Resolves user's IP address (IPv4/IPv6) to the nearest postal code center. |
| GET |
/v1/autocomplete /v1/autocomplete |
Search for cities with real-time UI suggestions. Optimized for high-speed frontend binding. |
| GET |
/v1/geo/distance /v1/geo/distance |
Calculate the straight-line distance between two global postal codes. |
| POST |
/v1/lookup/batch /v1/lookup/batch |
Lookup up to 100 postal codes in a single request. Perfect for data cleaning and enrichment pipelines. |
| GET |
/v1/country /v1/country |
Fetch localized names, phone codes, and currency for a specific nation. |
| GET |
/v1/lookup /v1/lookup |
Retrieve detailed metadata (coordinates, state, city) for a specific postal code. |
| GET |
/v1/geo/countries /v1/geo/countries |
Paginated list of all countries supported by our geographical hierarchy. |
| GET |
/v1/geo/nearest /v1/geo/nearest |
Find the closest 5-10 postal code boundaries to a given point. |
| GET |
/v1/geo/states /v1/geo/states |
Returns all provinces or states found within a target country. |
| GET |
/v1/search /v1/search |
Fuzzy-search for postal codes by city name, code, or country. Handles misspellings and partial matches. |
| GET |
/v1/geo/cities /v1/geo/cities |
Retrieve all cities belonging to a specific state/province. |
| GET |
/v1/health /v1/health |
Detailed health check for v1 endpoints and dependencies. |
World Postal Codes pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | 1 / second |
|
| PRO | $10 / month | 5 / second |
|
| ULTRA Recommended | $29 / month | 20 / second |
|
| MEGA | $99 / month | 60 / second |
|