by substack

substack / provinces

state and province lists for countries

212 Stars 96 Forks Last release: Not found Other 96 Commits 21 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:


state and province lists for countries


This module currently has states and provinces for:

  • united states (US)
  • united kingdom (GB)
  • canada (CA)
  • mexico (MX)
  • australia (AU)
  • china (CN)
  • germany (DE)
  • belgium (BE)
  • netherlands (NL)
  • denmark (DK)
  • Turkey (TR)
  • Indonesia (ID)
  • Jordan (JO)
  • India (IN)
  • Cambodia (KH)
  • Ethiopia (ET)
  • Peru (PE)
  • Cuba (CU)
  • Argentina (AR)
  • Chile (CL)
  • Bolivia (BO)
  • Spain (ES)
  • Bangladesh (BD)
  • Pakistan (PK)
  • Nigeria (NG)
  • Japan (JP)
  • austria (AT)
  • brazil (BR)
  • Philippines (PH)
  • Vietnam (VN)
  • Costa Rica (CR)


var provinces = require('provinces')

Requiring the module gives you an array of object rows.

data format

Each row consists of:

  • - full name of the province or state
  • - country abbreviation
  • row.short - optional 2 or 3 character short name
  • row.alt - optional array of additional names and abbreviations
  • row.region - optional region of a country (for example: "Wales")


With npm do:

npm install provinces



We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.