International Address Formats

Postal address formats, postal-code validation and subdivisions for about 240 countries from a bundled Google i18n snapshot.

payments ON MAINNET (real money) · 8 live endpoints

EndpointPriceWhat it answers
GET /address-format$0.02A country's postal address layout: line order template, required fields, uppercase rules and field labels.
GET /address-parse-hints$0.02Guess which country a postal code belongs to from its shape among candidates, flagging ambiguity honestly.
GET /country-address-fields$0.02Which address fields a country uses and their local labels: state/province/county, city, district, postal code.
GET /format-address$0.02Render address parts into a country's standard multi-line mailing format with its uppercase rules; reports missing fields.
GET /po-box-check$0.02Heuristic check whether an address line uses PO box wording in English, German, French, Spanish and more; not proof.
GET /postal-code-check$0.02Check a postal code against a country's pattern, and a state/province's prefix pattern where the data lists one.
GET /postal-code-examples$0.02Sample postal codes for a country from the dataset's examples, each checked against the country's own pattern.
GET /subdivisions$0.02Administrative divisions (states, provinces) of a country with codes, names and postal prefix patterns, from the dataset.

GET /catalog returns this list as JSON. Activity hub · uptime.


Computed from a bundled snapshot of Google's open i18n address data. Formats and postal-code patterns can be out of date or incomplete; a code matching a pattern does not prove it exists. Not a postal authority. Every paid response carries a disclaimer field.