See the reuse

Validate ZIP Codes with Regular Expressions

See the reuse

Description

Validate ZIP Codes with Regular Expressions

A Library of JavaScript Regular Expressions for validating if a specific Zip-code exists in a specific Country.

Not every 5 digit number is automatically a zip code... As of now Regular Expression seem to be the fastest way of validating if a zip code actually exists. No slow backend validation needed, just some fancy RegExp.

So Why val-zip? Because it is free for commercial use and it is super fast and light weight with only 448kB size. As of now the Regular Expressions for Germany, Austria, Switzerland, USA (5-Digit version), Belgium, Denmark, Czechia, Finland, Norway, Italy, Spain, Estonia, Iceland, France, Luxembourg are available with more coming asap.

Usage

Download via Node Package Manager (NPM):

npm install val-zip

Import via Content Delivery Network (CDN):

<script type="module" src="https://cdn.skypack.dev/val-zip@latest" corossorigin="anonymous" referrerpolicy="no-referrer"></script>
<script type="module" src="https://cdn.jsdelivr.net/npm/val-zip@latest/dist/val-zip.umd.js" crossorigin="anonymous" referrerpolicy="no-referrer"></script>
<script type="module" src="https://unpkg.com/val-zip@1.0.12/dist/va-zip.udm.js" crossorigin="anonymous" referrerpolicy="no-referrer"></script>

Note: CDN is still wip, so error may occur. In doubt use skypack cdn

Example

import valZip from "val-zip"; // make sure to use type="module" or the ".mjs" file extension
// alternative: const valZip = require("val-zip"); 
// note: the require function is nodejs specific and is not available in a ESM or Browser environment.
// make sure to use type="commonjs" or the ".cjs" file extension

// let's say a random user puts in a zipcode somehow and you want to validate if the zip code exists.

var userCountry = "US"; //  ISO 3166 Country Code; string
var inputZip_1 = "12345"; // fake, this zipcode does NOT exist in the United States 
var inputZip_2 = "00601"; // reak, exists


valZip(inputZip_1, userCountry) // returns false
valZip(inputZip_2, userCountry) // returns true

Zip Code Sources

Note: All data is heavily modified and does not resemble the original data base at all

country last update license source
Austria 04.01.2023 none Österreichische Post Aktiengesellschaft
Belgium 21.11.2021 none Bpost
Switzerland 01.01.2023 CC-BY Die Schweizerische Post
Czechia 01.01.2023 none Česká pošta
Germany 01.06.2019 none Launix
Denmark 22.06.2022 none PostNord Danmark
United States 31.12.2020 none Internal Revenue Service, US Census
Norway 01.10.2022 none Osten Norge AS
Finland 30.01.2023 none Posti Group Oy
Italy 26.11.2020 Eurostat free re-use of data Eurostat
Spain 26.11.2020 Eurostat free re-use of data Eurostat
Estonia 05.02.2023 none Republic of Estonia
Iceland 06.02.2023 none Íslandspóstur
France 06.02.2023 Open License v2.0 La Poste Groupe
Luxembourg 06.02.2023 CC-0 Portail Open Data

Some Countries are missing, just because the official zipcode database is either paywalled or entirely copyrighted.

This is the List of countries I am unable to source data from:

country limitation source
Poland only with permit Poczta Polska Spółka Akcyjna
Sweden paid only Postnummerservice Norden AB
Australia paid only Australia Post

MIT License
Copyright (c) 2022-today Leonhard Maier

Leonhard Maier

Topic

Geospatial data

Type

API

Tags

  • address-validation

  • api

  • austria

  • belgium

  • code-postal

  • codes-postaux

  • czechia

  • denmark

  • estonia

  • finland

  • france

  • geojson

  • iceland

  • italy

  • javascript

  • json

  • luxembourg

  • nodejs

  • norway

  • npm

  • postal-codes

  • postcode

  • regex

  • regular-expression

  • spain

  • switzerland

  • tool

  • validation

  • validator

  • vuejs

  • web

  • website

  • zip-codes

  • zipcode

Creation date

February 7, 2023

Last update

July 21, 2025

1 used dataset

Discussions

There are no discussions for this reuse yet.

Reuses from the same creator

There are no other reuses from this creator.