PostalDataPI Documentation

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

Why PostalDataPI?

• Global coverage -- 70+ countries, from the US to Japan to Germany
• Fast -- Sub-10ms responses powered by in-memory caching
• 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 70+ supported countries
• Error Handling -- HTTP status codes and SDK error classes