Need help with provinces?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

219 Stars 101 Forks Other 96 Commits 8 Opened issues


state and province lists for countries

Services available


Need anything else?

Contributors list


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.