Skip to main content

States

The States API provides information about each state, including:

  • state abbreviation (state)
  • state name (name)
  • country code (country)
  • list of NPAs (npas)

For ease in classifying NANP (+1) telephone numbers geographically, we use the term "state" to indicate the applicable state, province, territory, or country within the North American Numbering Plan:

United States

  • 50 US states
  • DC = District of Colombia

United States Territories

  • AS = American Samoa
  • GU = Guam
  • NN = Northern Mariana Islands
  • PR = Puerto Rico
  • VI = US Virgin Islands

Canada & Territories

  • AB = Alberta
  • BC = British Colombia
  • MB = Manitoba
  • NB = New Brunswick
  • NL = Newfoundland and Labrador
  • NS = Nova Scotia
  • NT = Northwest Territories
  • ON = Ontario
  • QC = Quebec
  • SK = Saskatchewan

For all other NANP regions, we assign a "state" as follows:

  • AI = Anguilla
  • AN = Antigua and Barbuda
  • BD = Barbados
  • BM = Bermuda
  • BS = Bahamas
  • BV = British Virgin Islands
  • CQ = Cayman Islands
  • DM = Dominica
  • DR = Dominican Republic
  • GN = Grenada
  • JM = Jamaica
  • KA = Saint Kitts and Nevis
  • RT = Montserrat
  • SA = Saint Lucia
  • SM = Sint Maarten
  • TC = Turks and Caicos Islands
  • TR = Trinidad and Tobago
  • ZF = Saint Vincent and the Grenadines

We assume that every NPA is associated with exactly one "state". However, some Canadian NPAs span multiple provinces & territories. In order to keep our data model simple, we gloss over three Canadian provinces as follows:

  • Yukon (YT) and Nunavut (NU) are considered part of Northwest Territories (NT)
  • Prince Edward Island (PE) is considered part of Nova Scotia (NS)

The most common use of the States API is to obtain a list of state abbreviations, names, and associated NPAs for populating dropdowns within a UI:

curl https://www.numberbarn.com/api/states