zipcodes.js

Free postal code validation for the web.

Features

• Validates against expected regex patterns of the country.
• Looks up the code via a CDN for accurate validation and geographical data.

Usage

<script src="https://cdn.jsdelivr.net/gh/zipcodes/zipcodes.js@1.0/zipcodes.min.js"></script>

getZipCode('US', '90210', function (result) {
    console.log(result);
});

Output:

{
    "input":{
        "country": "US",
        "zip": "90210"
    },
    "lookup":{
        "countryCode": "US",
        "postalCode": "90210",
        "placeName": "Beverly Hills",
        "adminName1": "California",
        "adminCode1": "CA",
        "adminName2": "Los Angeles",
        "adminCode2": "037",
        "adminName3": "",
        "adminCode3": "",
        "latitude": "34.0901",
        "longitude": "-118.4065",
        "accuracy": "4"
    },
    "pattern": /^\d{5}(-\d{4})?$/,
    "validPattern": true,
    "validLookup": true,
    "valid": true
}

Supported Countries

Country codes should follow ISO 3166-1 alpha-2

Flag	Code	Country	Regex	Lookup
	AD	Andorra	✓	✓
	AE	United Arab Emirates	✖	✖
	AF	Afghanistan	✖	✖
	AG	Antigua and Barbuda	✖	✖
	AI	Anguilla	✖	✖
	AL	Albania	✖	✖
	AM	Armenia	✓	✖
	AO	Angola	✖	✖
	AQ	Antarctica	✖	✖
	AR	Argentina	✓	✓
	AS	American Samoa	✓	✓
	AT	Austria	✓	✓
	AU	Australia	✓	✓
	AW	Aruba	✖	✖
	AX	sort	✖	✓
	AZ	Azerbaijan	✓	✖
	BA	Bosnia and Herzegovina	✓	✖
	BB	Barbados	✖	✖
	BD	Bangladesh	✓	✓
	BE	Belgium	✓	✓
	BF	Burkina Faso	✖	✖
	BG	Bulgaria	✓	✓
	BH	Bahrain	✖	✖
	BI	Burundi	✖	✖
	BJ	Benin	✓	✖
	BL	Saint Barthélemy	✖	✖
	BM	Bermuda	✓	✓
	BN	Brunei	✓	✖
	BO	Bolivia	✖	✖
	BQ	Caribbean Netherlands	✖	✖
	BR	Brazil	✓	✓
	BS	The Bahamas	✖	✖
	BT	Bhutan	✖	✖
	BV	Bouvet Island	✖	✖
	BW	Botswana	✖	✖
	BY	Belarus	✓	✓
	BZ	Belize	✖	✖
	CA	Canada	✓	✓
	CC	Cocos (Keeling) Islands	✖	✖
	CD	Democratic Republic of the Congo	✖	✖
	CF	Central African Republic	✖	✖
	CG	Republic of the Congo	✖	✖
	CH	Switzerland	✓	✓
	CI	Cote d'Ivoire	✖	✖
	CK	Cook Islands	✖	✖
	CL	Chile	✖	✖
	CM	Cameroon	✖	✖
	CN	China	✓	✖
	CO	Colombia	✖	✓
	CR	Costa Rica	✖	✓
	CU	Cuba	✓	✖
	CV	Cabo Verde	✖	✖
	CW	Curaçao	✖	✖
	CX	Christmas Island	✓	✖
	CY	Cyprus	✓	✖
	CZ	Czechia	✓	✓
	DE	Germany	✓	✓
	DJ	Djibouti	✖	✖
	DK	Denmark	✓	✓
	DM	Dominica	✖	✖
	DO	Dominican Republic	✖	✓
	DZ	Algeria	✓	✓
	EC	Ecuador	✖	✖
	EE	Estonia	✓	✖
	EG	Egypt	✖	✖
	EH	Western Sahara	✖	✖
	ER	Eritrea	✖	✖
	ES	Spain	✓	✓
	ET	Ethiopia	✖	✖
	FI	Finland	✓	✓
	FJ	Fiji	✖	✖
	FK	Falkland Islands	✖	✖
	FM	Federated States of Micronesia	✓	✓
	FO	Faroe Islands	✓	✓
	FR	France	✓	✓
	GA	Gabon	✖	✖
	GB	United Kingdom	✓	✓
	GD	Grenada	✖	✖
	GE	Georgia	✖	✖
	GF	French Guiana	✓	✓
	GG	Guernsey	✖	✓
	GH	Ghana	✖	✖
	GI	Gibraltar	✖	✖
	GL	Greenland	✓	✓
	GM	The Gambia	✖	✖
	GN	Guinea	✖	✖
	GP	Guadeloupe	✓	✓
	GQ	Equatorial Guinea	✖	✖
	GR	Greece	✓	✖
	GS	South Georgia and the South Sandwich Islands	✖	✖
	GT	Guatemala	✓	✓
	GU	Guam	✓	✓
	GW	Guinea-Bissau	✓	✖
	GY	Guyana	✖	✖
	HK	Hong Kong	✖	✖
	HM	Heard Island and McDonald Islands	✖	✖
	HN	Honduras	✖	✖
	HR	Croatia	✓	✓
	HT	Haiti	✖	✖
	HU	Hungary	✓	✓
	ID	Indonesia	✓	✖
	IE	Republic of Ireland	✓	✓
	IL	Israel	✓	✖
	IM	Isle of Man	✖	✓
	IN	India	✓	✓
	IO	British Indian Ocean Territory	✖	✖
	IQ	Iraq	✖	✖
	IR	Iran	✖	✖
	IS	Iceland (IC)	✓	✓
	IT	Italy	✓	✓
	JE	Jersey	✖	✓
	JM	Jamaica	✖	✖
	JO	Jordan	✖	✖
	JP	Japan	✓	✓
	KE	Kenya	✓	✖
	KG	Kyrgyzstan	✓	✖
	KH	Cambodia	✖	✖
	KI	Kiribati	✖	✖
	KM	Comoros	✖	✖
	KN	Saint Kitts and Nevis	✖	✖
	KP	North Korea	✖	✖
	KR	South Korea	✓	✖
	KW	Kuwait	✓	✖
	KY	Cayman Islands	✖	✖
	KZ	Kazakhstan	✓	✖
	LA	Laos	✖	✖
	LB	Lebanon	✖	✖
	LC	Saint Lucia	✖	✖
	LI	Liechtenstein	✓	✓
	LK	Sri Lanka	✖	✓
	LR	Liberia	✖	✖
	LS	Lesotho	✖	✖
	LT	Lithuania	✓	✓
	LU	Luxembourg	✓	✓
	LV	Latvia	✓	✓
	LY	Libya	✖	✖
	MA	Morocco	✓	✖
	MC	Monaco	✖	✓
	MD	Moldova	✓	✓
	ME	Montenegro	✓	✖
	MF	Collectivity of Saint Martin	✖	✖
	MG	Madagascar	✓	✖
	MH	Marshall Islands	✓	✓
	MK	Republic of Macedonia	✓	✓
	ML	Mali	✖	✖
	MM	Myanmar	✓	✖
	MN	Mongolia	✓	✖
	MO	Macau	✖	✖
	MP	Northern Mariana Islands	✓	✓
	MQ	Martinique	✓	✓
	MR	Mauritania	✖	✖
	MS	Montserrat	✖	✖
	MT	Malta	✓	✓
	MU	Mauritius	✖	✖
	MV	Maldives	✓	✖
	MW	Malawi	✖	✖
	MX	Mexico	✓	✓
	MY	Malaysia	✓	✓
	MZ	Mozambique	✓	✖
	NA	Namibia	✖	✖
	NC	New Caledonia	✖	✓
	NE	Niger	✖	✖
	NF	Norfolk Island	✖	✖
	NG	Nigeria	✖	✖
	NI	Nicaragua	✖	✖
	NL	Netherlands	✓	✓
	NO	Norway	✓	✓
	NP	Nepal	✖	✖
	NR	Nauru	✖	✖
	NU	Niue	✖	✖
	NZ	New Zealand	✓	✓
	OM	Oman	✖	✖
	PA	Panama	✖	✖
	PE	Peru	✖	✖
	PF	French Polynesia	✖	✖
	PG	Papua New Guinea	✖	✖
	PH	Philippines	✓	✓
	PK	Pakistan	✓	✓
	PL	Poland	✓	✓
	PM	Saint Pierre and Miquelon	✓	✓
	PN	Pitcairn Islands	✖	✖
	PR	Puerto Rico	✓	✓
	PS	State of Palestine	✓	✖
	PT	Portugal	✓	✓
	PW	Palau	✓	✓
	PY	Paraguay	✖	✖
	QA	Qatar	✖	✖
	RE	Réunion	✓	✓
	RO	Romania	✓	✓
	RS	Serbia.	✓	✖
	RU	Russia	✓	✓
	RW	Rwanda	✖	✖
	SA	Saudi Arabia	✓	✖
	SB	Solomon Islands	✖	✖
	SC	Seychelles	✖	✖
	SD	Sudan	✓	✖
	SE	Sweden	✓	✓
	SG	Singapore	✓	✖
	SH	Saint Helena, Ascension and Tristan da Cunha	✖	✖
	SI	Slovenia	✓	✓
	SJ	Svalbard and Jan Mayen	✖	✓
	SK	Slovakia	✓	✓
	SL	Sierra Leone	✖	✖
	SM	San Marino	✓	✓
	SN	Senegal	✖	✖
	SO	Somalia	✖	✖
	SR	Suriname	✖	✖
	SS	South Sudan	✖	✖
	ST	São Tomé and Príncipe	✖	✖
	SV	El Salvador	✖	✖
	SX	Sint Maarten	✖	✖
	SY	Syria	✖	✖
	SZ	Swaziland	✓	✖
	TC	Turks and Caicos Islands	✖	✖
	TD	Chad	✖	✖
	TF	French Southern and Antarctic Lands	✖	✖
	TG	Togo	✖	✖
	TH	Thailand	✓	✓
	TJ	Tajikistan	✓	✖
	TK	Tokelau	✖	✖
	TL	East Timor	✖	✖
	TM	Turkmenistan	✓	✖
	TN	Tunisia	✓	✖
	TO	Tonga	✖	✖
	TR	Turkey	✓	✓
	TT	Trinidad and Tobago	✖	✖
	TV	Tuvalu	✖	✖
	TW	Taiwan	✓	✖
	TZ	Tanzania	✖	✖
	UA	Ukraine	✓	✓
	UG	Uganda	✖	✖
	UM	United States Minor Outlying Islands	✖	✖
	US	United States	✓	✓
	UY	Uruguay	✓	✓
	UZ	Uzbekistan	✓	✖
	VA	Vatican City	✖	✓
	VC	Saint Vincent and the Grenadines	✖	✖
	VE	Venezuela	✓	✖
	VG	British Virgin Islands	✖	✖
	VI	United States Virgin Islands	✓	✓
	VN	Vietnam	✓	✖
	VU	Vanuatu	✖	✖
	WF	Wallis and Futuna	✖	✓
	WS	Samoa	✖	✖
	YE	Yemen	✖	✖
	YT	Mayotte	✖	✓
	ZA	South Africa	✓	✓
	ZM	Zambia	✓	✖
	ZW	Zimbabwe	✖	✖

Sources

• Some patterns borrowed from https://github.com/sarcadass/i18n-zipcodes
• Zipcode database from http://download.geonames.org