The Reference Docs Developer Hub

Welcome to the Reference Docs developer hub. You'll find comprehensive guides and documentation to help you start working with Reference Docs as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Countries Provinces and States

Recurly converts all countries, Canadian provinces, and U.S. states to ISO alpha-2 codes in our database. We use these codes when conmmunicating with payment gateways and third parties. If we are unable to match the country or province to one of our codes, we will store the raw input you give us. We recommend you send all countries, provinces and states to us with capitalized ISO alpha-2 codes in order to minimize address validation errors with your payment gateways or tax calculation.

Countries

  • AC - Ascension Island
  • AD - Andorra
  • AE - United Arab Emirates
  • AF - Afghanistan
  • AG - Antigua and Barbuda
  • AI - Anguilla
  • AL - Albania
  • AM - Armenia
  • AN - Netherlands Antilles
  • AO - Angola
  • AQ - Antarctica
  • AR - Argentina
  • AS - American Samoa
  • AT - Austria
  • AU - Australia
  • AW - Aruba
  • AX - Åland Islands
  • AZ - Azerbaijan
  • BA - Bosnia and Herzegovina
  • BB - Barbados
  • BD - Bangladesh
  • BE - Belgium
  • BF - Burkina Faso
  • BG - Bulgaria
  • BH - Bahrain
  • BI - Burundi
  • BJ - Benin
  • BL - Saint Barthélemy
  • BM - Bermuda
  • BN - Brunei
  • BO - Bolivia
  • BQ - British Antarctic Territory
  • BR - Brazil
  • BS - Bahamas
  • BT - Bhutan
  • BV - Bouvet Island
  • BW - Botswana
  • BY - Belarus
  • BZ - Belize
  • CA - Canada
  • CC - Cocos [Keeling] Islands
  • CD - Congo - Kinshasa
  • CD - Congo [DRC]
  • CF - Central African Republic
  • CG - Congo - Brazzaville
  • CG - Congo [Republic]
  • CH - Switzerland
  • CI - Côte d’Ivoire
  • CI - Ivory Coast
  • CK - Cook Islands
  • CL - Chile
  • CM - Cameroon
  • CN - China
  • CO - Colombia
  • CP - Clipperton Island
  • CR - Costa Rica
  • CS - Serbia and Montenegro
  • CT - Canton and Enderbury Islands
  • CU - Cuba
  • CV - Cabo Verde
  • CX - Christmas Island
  • CY - Cyprus
  • CZ - Czech Republic
  • DE - Germany
  • DG - Diego Garcia
  • DJ - Djibouti
  • DK - Denmark
  • DM - Dominica
  • DO - Dominican Republic
  • DZ - Algeria
  • EA - Ceuta and Melilla
  • EC - Ecuador
  • EE - Estonia
  • EG - Egypt
  • EH - Western Sahara
  • ER - Eritrea
  • ES - Spain
  • ET - Ethiopia
  • FI - Finland
  • FJ - Fiji
  • FK - Falkland Islands
  • FK - Falkland Islands [Islas Malvinas]
  • FM - Micronesia
  • FO - Faroe Islands
  • FQ - French Southern and Antarctic Territories
  • FR - France
  • FX - Metropolitan France
  • GA - Gabon
  • GB - United Kingdom
  • GD - Grenada
  • GE - Georgia
  • GF - French Guiana
  • GG - Guernsey
  • GH - Ghana
  • GI - Gibraltar
  • GL - Greenland
  • GM - Gambia
  • GN - Guinea
  • GP - Guadeloupe
  • GQ - Equatorial Guinea
  • GR - Greece
  • GS - South Georgia and the South Sandwich Islands
  • GT - Guatemala
  • GU - Guam
  • GW - Guinea-Bissau
  • GY - Guyana
  • HK - Hong Kong
  • HM - Heard Island and McDonald Islands
  • HN - Honduras
  • HR - Croatia
  • HT - Haiti
  • HU - Hungary
  • IC - Canary Islands
  • ID - Indonesia
  • IE - Ireland
  • IL - Israel
  • IM - Isle of Man
  • IN - India
  • IO - British Indian Ocean Territory
  • IQ - Iraq
  • IR - Iran
  • IS - Iceland
  • IT - Italy
  • JE - Jersey
  • JM - Jamaica
  • JO - Jordan
  • JP - Japan
  • JT - Johnston Island
  • KE - Kenya
  • KG - Kyrgyzstan
  • KH - Cambodia
  • KI - Kiribati
  • KM - Comoros
  • KN - Saint Kitts and Nevis
  • KP - North Korea
  • KR - South Korea
  • KW - Kuwait
  • KY - Cayman Islands
  • KZ - Kazakhstan
  • LA - Laos
  • LB - Lebanon
  • LC - Saint Lucia
  • LI - Liechtenstein
  • LK - Sri Lanka
  • LR - Liberia
  • LS - Lesotho
  • LT - Lithuania
  • LU - Luxembourg
  • LV - Latvia
  • LY - Libya
  • MA - Morocco
  • MC - Monaco
  • MD - Moldova
  • ME - Montenegro
  • MF - Saint Martin
  • MG - Madagascar
  • MH - Marshall Islands
  • MI - Midway Islands
  • MK - Macedonia
  • MK - Macedonia [FYROM]
  • ML - Mali
  • MM - Myanmar [Burma]
  • MN - Mongolia
  • MO - Macau SAR China
  • MO - Macau
  • MP - Northern Mariana Islands
  • MQ - Martinique
  • MR - Mauritania
  • MS - Montserrat
  • MT - Malta
  • MU - Mauritius
  • MV - Maldives
  • MW - Malawi
  • MX - Mexico
  • MY - Malaysia
  • MZ - Mozambique
  • NA - Namibia
  • NC - New Caledonia
  • NE - Niger
  • NF - Norfolk Island
  • NG - Nigeria
  • NI - Nicaragua
  • NL - Netherlands
  • NO - Norway
  • NP - Nepal
  • NQ - Dronning Maud Land
  • NR - Nauru
  • NU - Niue
  • NZ - New Zealand
  • OM - Oman
  • PA - Panama
  • PC - Pacific Islands Trust Territory
  • PE - Peru
  • PF - French Polynesia
  • PG - Papua New Guinea
  • PH - Philippines
  • PK - Pakistan
  • PL - Poland
  • PM - Saint Pierre and Miquelon
  • PN - Pitcairn Islands
  • PR - Puerto Rico
  • PS - Palestinian Territories
  • PT - Portugal
  • PU - U.S. Miscellaneous Pacific Islands
  • PW - Palau
  • PY - Paraguay
  • PZ - Panama Canal Zone
  • QA - Qatar
  • QO - Outlying Oceania
  • RE - Réunion
  • RO - Romania
  • RS - Serbia
  • RU - Russia
  • RW - Rwanda
  • SA - Saudi Arabia
  • SB - Solomon Islands
  • SC - Seychelles
  • SD - Sudan
  • SE - Sweden
  • SG - Singapore
  • SH - Saint Helena
  • SI - Slovenia
  • SJ - Svalbard and Jan Mayen
  • SK - Slovakia
  • SL - Sierra Leone
  • SM - San Marino
  • SN - Senegal
  • SO - Somalia
  • SR - Suriname
  • ST - São Tomé and Príncipe
  • SV - El Salvador
  • SY - Syria
  • SZ - Swaziland
  • TA - Tristan da Cunha
  • TC - Turks and Caicos Islands
  • TD - Chad
  • TF - French Southern Territories
  • TG - Togo
  • TH - Thailand
  • TJ - Tajikistan
  • TK - Tokelau
  • TL - Timor-Leste
  • TL - East Timor
  • TM - Turkmenistan
  • TN - Tunisia
  • TO - Tonga
  • TR - Turkey
  • TT - Trinidad and Tobago
  • TV - Tuvalu
  • TW - Taiwan
  • TZ - Tanzania
  • UA - Ukraine
  • UG - Uganda
  • UM - U.S. Minor Outlying Islands
  • US - United States
  • UY - Uruguay
  • UZ - Uzbekistan
  • VA - Vatican City
  • VC - Saint Vincent and the Grenadines
  • VD - North Vietnam
  • VE - Venezuela
  • VG - British Virgin Islands
  • VI - U.S. Virgin Islands
  • VN - Vietnam
  • VU - Vanuatu
  • WF - Wallis and Futuna
  • WK - Wake Island
  • WS - Samoa
  • YD - People's Democratic Republic of Yemen
  • YE - Yemen
  • YT - Mayotte
  • ZA - South Africa
  • ZM - Zambia
  • ZW - Zimbabwe

Canadian Provinces

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

U.S. States

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