States/Provinces

States/Provinces

Description¶

The states endpoint will retrieve the list of states that are present with the associated Country.

Request¶

Endpoint¶
ui/refdata/v1/states/countrycode
Note

Replace countrycode in the request above with the user selected countrycode data ex:USA

Method¶
GET

Response¶


   [
    {
        "id": 1,
        "stateCode": "AL",
        "stateText": "Alabama",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 2,
        "stateCode": "AK",
        "stateText": "Alaska",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 3,
        "stateCode": "AS",
        "stateText": "American Samoa",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 4,
        "stateCode": "AZ",
        "stateText": "Arizona",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 5,
        "stateCode": "AR",
        "stateText": "Arkansas",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 6,
        "stateCode": "CA",
        "stateText": "California",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 7,
        "stateCode": "CO",
        "stateText": "Colorado",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 8,
        "stateCode": "CT",
        "stateText": "Connecticut",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 9,
        "stateCode": "DE",
        "stateText": "Delaware",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 10,
        "stateCode": "DC",
        "stateText": "Dist. of Columbia",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 11,
        "stateCode": "FL",
        "stateText": "Florida",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 12,
        "stateCode": "GA",
        "stateText": "Georgia",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 13,
        "stateCode": "GU",
        "stateText": "Guam",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 14,
        "stateCode": "HI",
        "stateText": "Hawaii",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 15,
        "stateCode": "ID",
        "stateText": "Idaho",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 16,
        "stateCode": "IL",
        "stateText": "Illinois",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 17,
        "stateCode": "IN",
        "stateText": "Indiana",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 18,
        "stateCode": "IA",
        "stateText": "Iowa",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 19,
        "stateCode": "KS",
        "stateText": "Kansas",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 20,
        "stateCode": "KY",
        "stateText": "Kentucky",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 21,
        "stateCode": "LA",
        "stateText": "Louisiana",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 22,
        "stateCode": "ME",
        "stateText": "Maine",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 23,
        "stateCode": "MD",
        "stateText": "Maryland",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 25,
        "stateCode": "MA",
        "stateText": "Massachusetts",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 26,
        "stateCode": "MI",
        "stateText": "Michigan",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 28,
        "stateCode": "MN",
        "stateText": "Minnesota",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 29,
        "stateCode": "MS",
        "stateText": "Mississippi",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 30,
        "stateCode": "MO",
        "stateText": "Missouri",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 31,
        "stateCode": "MT",
        "stateText": "Montana",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 32,
        "stateCode": "NE",
        "stateText": "Nebraska",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 33,
        "stateCode": "NV",
        "stateText": "Nevada",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 34,
        "stateCode": "NH",
        "stateText": "New Hampshire",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 35,
        "stateCode": "NJ",
        "stateText": "New Jersey",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 36,
        "stateCode": "NM",
        "stateText": "New Mexico",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 37,
        "stateCode": "NY",
        "stateText": "New York",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 38,
        "stateCode": "NC",
        "stateText": "North Carolina",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 39,
        "stateCode": "ND",
        "stateText": "North Dakota",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 40,
        "stateCode": "MP",
        "stateText": "Northern Mariana Islands",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 41,
        "stateCode": "OH",
        "stateText": "Ohio",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 42,
        "stateCode": "OK",
        "stateText": "Oklahoma",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 43,
        "stateCode": "OR",
        "stateText": "Oregon",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 45,
        "stateCode": "PA",
        "stateText": "Pennsylvania",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 46,
        "stateCode": "PR",
        "stateText": "Puerto Rico",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 47,
        "stateCode": "RI",
        "stateText": "Rhode Island",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 48,
        "stateCode": "SC",
        "stateText": "South Carolina",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 49,
        "stateCode": "SD",
        "stateText": "South Dakota",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 50,
        "stateCode": "TN",
        "stateText": "Tennessee",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 51,
        "stateCode": "TX",
        "stateText": "Texas",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 55,
        "stateCode": "VI",
        "stateText": "U.S. Virgin Islands",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 52,
        "stateCode": "UT",
        "stateText": "Utah",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 53,
        "stateCode": "VT",
        "stateText": "Vermont",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 54,
        "stateCode": "VA",
        "stateText": "Virginia",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 56,
        "stateCode": "WA",
        "stateText": "Washington",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 57,
        "stateCode": "WV",
        "stateText": "West Virginia",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 58,
        "stateCode": "WI",
        "stateText": "Wisconsin",
        "countryId": 1,
        "countryText": null
    },
    {
        "id": 59,
        "stateCode": "WY",
        "stateText": "Wyoming",
        "countryId": 1,
        "countryText": null
    }
]

States (USA)¶

State	State Code
Alabama	AL
Alaska	AK
American Samoa	AS
Arizona	AZ
Arkansas	AR
California	CA
Colorado	CO
Connecticut	CT
Delaware	DE
Dist. of Columbia	DC
Florida	FL
Georgia	GA
Guam	GU
Hawaii	HI
Idaho	ID
Illinois	IL
Indiana	IN
Iowa	IA
Kansas	KS
Kentucky	KY
Louisiana	LA
Maine	ME
Maryland	MD
Marshall Islands	MH
Massachusetts	MA
Michigan	MI
Micronesia	FM
Minnesota	MN
Mississippi	MS
Missouri	MO
Montana	MT
Nebraska	NE
Nevada	NV
New Hampshire	NH
New Jersey	NJ
New Mexico	NM
New York	NY
North Carolina	NC
North Dakota	ND
Northern Marianas	MP
Ohio	OH
Oklahoma	OK
Oregon	OR
Palau	PW
Pennsylvania	PA
Puerto Rico	PR
Rhode Island	RI
South Carolina	SC
South Dakota	SD
Tennessee	TN
Texas	TX
Utah	UT
Vermont	VT
Virginia	VA
Virgin Islands	VI
Washington	WA
West Virginia	WV
Wisconsin	WI
Wyoming	WY

Provinces (Canada)¶

Province	Province Code
Alberta	AB
British Columbia	BC
Manitoba	MB
New Brunswick	NB
Newfoundland and Labrador	NL
Northwest Territories	NT
Nova Scotia	NS
Nunavut	NU
Ontario	ON
Prince Edward Island	PE
Quebec	QC
Saskatchewan	SK
Yukon	YT

Brazil(BRA)¶

State	State Code
Acre	AC
Alagoas	AL
Amapá	AP
Amazonas	AM
Bahia	BA
Ceará	CE
Distrito Federal	DF
Espírito Santo	ES
Goiás	GO
Maranhão	MA
Mato Grosso	MT
Mato Grosso do Sul	MS
Minas Gerais	MG
Pará	PA
Paraíba	PB
Paraná	PR
Pernambuco	PE
Piauí	PI
Rio de Janeiro	RJ
Rio Grande do Norte	RN
Rio Grande do Sul	RS
Rondônia	RO
Roraima	RR
Santa Catarina	SC
São Paulo	SP
Sergipe	SE
Tocantins	TO

Mexico(MEX)¶

State	State Code
Aguascalientes	AG
Baja California	BN
Baja California Sur	BS
Campeche	CP
Chiapas	CS
Chihuahua	CI
Ciudad de México	DF
Coahuila	CH
Colima	CL
Durango	DG
Estado de México	MX
Guanajuato	GJ
Guerrero	GE
Hidalgo	HD
Jalisco	JA
Michoacán	MC
Morelos	MR
Nayarit	NA
Nuevo León	NL
Oaxaca	OA
Puebla	PU
Querétaro	QE
Quintana Roo	QI
San Luis Potosí	SL
Sinaloa	SI
Sonora	SO
Tabasco	TB
Tamaulipas	TA
Tlaxcala	TL
Veracruz	VC
Yucatán	YU
Zacatecas	ZA

Dominican Republic(DOM)¶

State	State Code
Azua	AZ
Bahoruco	BR
Barahona	BH
Dajabón	DA
Distrito Nacional	NC
Duarte	DU
El Seibo	SE
Elías Piña	EP
Espaillat	ES
Hato Mayor	HM
Hermanas Mirabal	SC
Independencia	IN
La Altagracia	AL
La Romana	RO
La Vega	VE
María Trinidad Sánchez	MT
Monseñor Nouel	MN
Monte Cristi	MC
Monte Plata	MP
Pedernales	PN
Pedernales	PV
Puerto Plata	PP
Samaná	SM
San Cristóbal	CR
San José de Ocoa	JO
San Juan	JU
San Pedro de Macorís	PM
Sánchez Ramírez	SZ
Santiago	ST
Santiago Rodríguez	SR
Santo Domingo	SD
Valverde	VA

Bahamas (BHS)¶

State	State Code
Acklins	AK
Berry Islands	BR
Bimini	BI
Black Point	BP
Cat Island	CI
Central Abaco	CB
Central Andros	CN
Central Eleuthera	CE
City of Freeport	FP
Crooked Island	CK
East Grand Bahama	EB
Exuma	EM
Grand Cay	GC
Green Turtle Cay	GT
Harbour Island	HB
Hope Town	HT
Inagua	IN
Long Island	LI
Mangrove Cay	MC
Mayaguana	MG
Moore's Island	MI
New Providence	NW
North Abaco	NA
North Andros	NN
North Eleuthera	NE
Ragged Island	RI
Rum Cay	RC
San Salvador	SS
South Abaco	SB
South Andros	SN
South Eleuthera	SE
Spanish Wells	SW
West Grand Bahama	WB

Argentina (ARG)¶

State	State Code
Buenos Aires	BA
Catamarca	CT
Chaco	CC
Chubut	CH
Ciudad de Buenos Aires	DF
Córdoba	CB
Corrientes	CN
Entre Ríos	ER
Formosa	FM
Jujuy	JY
La Pampa	LP
La Rioja	LR
Mendoza	MZ
Misiones	MN
Neuquén	NQ
Río Negro	RN
Salta	SA
San Juan	SJ
San Juan	SL
Santa Cruz	SC
Santa Fe	SF
Santiago del Estero	SE
Tierra del Fuego	TF
Tucumán	TM

Turks and Caicos Islands (TCA)¶

State	State Code
Caicos Islands	CI
Turks Islands	TI

Updated As Of Version 6.0.4.2