PostalDataPI Documentation

PostalDataPI is a global postal code API covering 240+ countries and territories with sub-5ms response times. Look up, validate, and search postal codes with a simple REST API.

Why PostalDataPI?

• Global coverage -- 240+ countries and territories, from the US to Japan to Germany
• Fast -- Sub-5ms cached response times
• Simple -- One flat rate ($0.000028/query), no tiers, no surprises
• Free to start -- 1,000 queries free, no credit card required
• Official SDKs -- Python and Node.js clients available

Get Started

1. Quick Start -- Make your first API call in under 5 minutes
2. Authentication -- API keys, pricing, and rate limits

API Reference

Endpoint	Description
POST /api/lookup	Get city and state for a postal code
POST /api/validate	Check if a postal code exists
POST /api/city	Find postal codes by city name
POST /api/metazip	Get coordinates, timezone, county, and more
POST /api/aboutapi	API version and coverage info

SDKs

Language	Package	Install
Python	postaldatapi	pip install postaldatapi
Node.js	postaldatapi	npm install postaldatapi

Guides

• Country Codes -- Full list of 240+ supported countries and territories
• Error Handling -- HTTP status codes and SDK error classes