zipcodes.js
Free postal code validation for the web.
- Validates against expected regex patterns of the country.
- Looks up the code via a CDN for accurate validation and geographical data.
<script src="https://cdn.jsdelivr.net/gh/zipcodes/zipcodes.js@1/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
}
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 |
✖ |
✖ |