Look up a code

GET https://postalcodecheck.com/api/postal/{COUNTRY}/{CODE}

Example: /api/postal/US/90210

{
  "country": "US",
  "country_name": "United States",
  "code": "90210",
  "places": [
    {"place": "Beverly Hills", "admin1": "California", "admin2": "Los Angeles", "lat": "34.0901", "lng": "-118.4065"}
  ],
  "url": "https://postalcodecheck.com/postal-code/US/90210",
  "source": "GeoNames (CC BY 4.0) via postalcodecheck.com"
}

List supported countries

GET https://postalcodecheck.com/api/countries

Returns every supported country with its ISO code, code count and format pattern.

Limits and terms

  • 500 requests per day and 30 per minute, per IP. Responses are cacheable for 24 hours.
  • Free for personal and commercial use. Attribution appreciated: a link to postalcodecheck.com.
  • Data: GeoNames postal dataset (CC BY 4.0), refreshed monthly.
  • Codes are matched after normalization (case and spaces ignored), so sw1a and SW1A are the same.

Need more volume? Contact [email protected].