United States Postal Code API

About United States ZIP code (Zone Improvement Plan)s

The US uses 5-digit ZIP codes, with an optional 4-digit extension (ZIP+4) for precise delivery. The first digit indicates the region: 0 for Northeast, 9 for West Coast.

Local term: ZIP code (Zone Improvement Plan) | Regex pattern: ^\d{5}(-\d{4})?$

API Usage Examples

curl -X POST https://postaldatapi.com/api/lookup \
  -H "Content-Type: application/json" \
  -d '{"zipcode": "90210", "country": "US", "apiKey": "YOUR_API_KEY"}'

from postaldatapi import PostalDataPI

client = PostalDataPI(api_key="YOUR_API_KEY")
result = client.lookup("90210", country="US")
print(result.place_name, result.latitude, result.longitude)

import { PostalDataPI } from 'postaldatapi';

const client = new PostalDataPI({ apiKey: 'YOUR_API_KEY' });
const result = await client.lookup('90210', { country: 'US' });
console.log(result.placeName, result.latitude, result.longitude);