# Prerequisites

First, you need to sign up (opens new window) for a Fetchify account.

When you sign up, you will receive an access token by email. There is no obligation to buy anything and you automatically get 100 trial lookups. If you need more lookups to test the integration, please get in touch (support@fetchify.com) and we will try to accommodate you.

# Integration

Pick your preferred method of integration or platform from the sidebar. We have ready-made integrations for a large selection of platforms.

# Testing

Before you go live, test the integration to make sure it is working properly.

The following postcodes can be tested without using any of your 100 trial lookups:

  • Address Auto-Complete: SL6 1QZ
  • Postcode Lookup: AA1 1AA, AA1 1AB, AA1 1AD and AA1 1AE

If you need assistance, drop us an email at support@fetchify.com – we will help!

# Going Live

Once your trial lookups run out, you will need to decide on the best purchasing option based on the volume of usage you expect on your site. If you would like us to advise you then please get in touch.

# Support

If you're still stuck after reading the docs then feel free to get in touch (opens new window) with us. We'd be happy to help!

# Supported Countries

Please refer to the following list of supported countries with their respective valid country codes if you are using our Address Auto-Complete library or integration feature.

Country codes are provided in 3 formats, following the ISO 3166 standard. Wikipedia (opens new window)

Name Long name alpha-2 alpha-3 numeric Official State Name
Afghanistan Afghanistan, Islamic Republic of AF AFG 4 Jomhuri-ye Eslami-ye Afghanestan
Albania Republic of Albania AL ALB 8 Republika e Shqiperise
Algeria Algeria, People's Democratic Republic of DZ DZA 12 Al Jumhuriyah al Jaza'iriyah ad Dimuqratiyah ash Sha'biyah
American Samoa American Samoa, Territory of AS ASM 16 Territory of American Samoa
Andorra Andorra, Principality of AD AND 20 Principat d'Andorra
Angola Angola, Republic of AO AGO 24 República de Angola
Anguilla Anguilla AI AIA 660 Anguilla
Antigua and Barbuda Antigua and Barbuda AG ATG 28 Antigua and Barbuda
Argentina Argentine Republic AR ARG 32 República Argentina
Armenia Armenia, Republic of AM ARM 51 Hayastani Hanrapetut'yun
Aruba Aruba AW ABW 533 Aruba
Australia Australia, Commonwealth of AU AUS 36 Commonwealth of Australia
Austria Austria, Federal Republic of AT AUT 40 Republik Österreich
Azerbaijan Azerbaijan, Republic of AZ AZE 31 Azarbaycan Respublikasi
Bahamas Bahamas, Commonwealth of the BS BHS 44 Commonwealth of the Bahamas
Bahrain Bahrain, Kingdom of BH BHR 48 Bahrain
Bangladesh Bangladesh, the People's Republic of BD BGD 50 Gano Projatontri Bangladesh
Barbados Barbados BB BRB 52 Barbados
Belarus Belarus, Republic of BY BLR 112 Respublika Bielarus
Belgium Belgium, Kingdom of BE BEL 56 Royaume de Belgique - Koninkrijk Belgie
Belize Belize BZ BLZ 84 Belize
Benin Benin, Republic of BJ BEN 204 Republique du Bénin
Bermuda Bermuda BM BMU 60 Bermuda
Bhutan Bhutan, Kingdom of BT BTN 64 Druk-yul
Bolivia Bolivia, Plurinational State of BO BOL 68 Estado Plurinacional de Bolivia
Bonaire, Sint Eustatius and Saba Bonaire, Sint Eustatius and Saba BQ BES 535 Bonaire, Sint Eustatius and Saba
Bosnia and Herzegovina Bosnia and Herzegovina, Federation of BA BIH 70 Federacija Bosne i Hercegovine
Botswana Republic of Botswana BW BWA 72 Republic of Botswana
Brazil Brazil, Republic of BR BRA 76 Republica Federativa do Brasil
British Indian Ocean Territory British Indian Ocean Territory IO IOT 86 British Indian Ocean Territory
British Virgin Islands Virgin Islands, British VG VGB 92 British Virgin Islands
Brunei Brunei Darussalam BN BRN 96 Negara Brunei Darussalam
Bulgaria Republic of Bulgaria BG BGR 100 Republika Bulgariya
Burkina Burkina Faso BF BFA 854 Burkina Faso
Burundi Republic of Burundi BI BDI 108 Republika y'u Burundi - République du Burundi
Cambodia Cambodia, Kingdom of KH KHM 116 Preah Réachéanachâkr Kâmpuchea
Cameroon Republic of Cameroon CM CMR 120 Republique du Cameroun
Canada Canada CA CAN 124 Canada
Cape Verde Republic of Cape Verde CV CPV 132 República de Cabo Verde
Cayman Islands Cayman Islands KY CYM 136 Cayman Islands
Central African Republic Central African Republic CF CAF 140 République Centrafricaine
Chad Chad, Republic of TD TCD 148 Repúblique du Tchad
Chile Chile, Republic of CL CHL 152 República de Chile
China China, People's Republic of (PRC) CN CHN 156 Zhonghua Renmin Gongheguo
Christmas Island Christmas Island CX CXR 162 Christmas Island
Cocos (Keeling) Islands Cocos (Keeling) Islands, Territory of the CC CCK 166 Cocos (Keeling) Islands
Colombia Colombia, Republic of CO COL 170 Republica de Colombia
Comoros Comoros, Union of the KM COM 174 Union des Comores - Udzima wa Komori
Congo Congo, Republic of the CG COG 178 République du Congo
Congo (Democratic Republic) Congo, the Democratic Republic of the CD COD 180 République Démocratique du Congo
Cook Islands Cook Islands CK COK 184 Cook Islands
Costa Rica Costa Rica, Republic of CR CRI 188 República de Costa Rica
Croatia Croatia, Republic of HR HRV 191 Republika Hrvatska
Cuba Cuba, Republic of CU CUB 192 Republica de Cuba
Curaçao Curaçao CW CUW 531 Curaçao
Cyprus Cyprus, Republic of CY CYP 196 Kypriake Demokratia
Czechia Czech Republic CZ CZE 203 Ceska Republika
Côte d'Ivoire Côte d'Ivoire, Republic of CI CIV 384 Republique du Côte d'Ivoire
Denmark Denmark, Kingdom of DK DNK 208 Kongeriget Danmark
Djibouti Djibouti, Republic of DJ DJI 262 République de Djibouti - Jumhuriyah Jibuti
Dominica Dominica, Commonwealth of DM DMA 212 Commonwealth of Dominica
Dominican Republic Dominican Republic DO DOM 214 Republica Dominicana
Ecuador Ecuador, Republic of EC ECU 218 República del Ecuador
Egypt Egypt, Arab Republic of EG EGY 818 Jumhuriyat Misr al-Arabiyah
El Salvador El Salvador, Republic of SV SLV 222 República de El Salvador
Equatorial Guinea Equatorial Guinea GQ GNQ 226 República de Guinea Ecuatorial
Eritrea Eritrea, State of ER ERI 232 Hagere Ertra
Estonia Estonia, Republic of EE EST 233 Eesti Vabariik
Ethiopia Ethiopia, Federal Democratic Republic of ET ETH 231 Ityop'iya Federalawi Demokrasiyawi Ripeblik
Falkland Islands Falkland Islands FK FLK 238 Falkland Islands
Faroe Islands Faroe Islands FO FRO 234 Føroyar
Fiji Fiji Islands, Republic of the FJ FJI 242 Republic of the Fiji Islands
Finland Finland, Republic of FI FIN 246 Suomen tasavalta
France French Republic FR FRA 250 Republique Francaise
French Guiana French Guiana GF GUF 254 Guyane
French Polynesia French Polynesia, Territory of PF PYF 258 Territoire de la Polynésie Française
Gabon Gabonese Republic GA GAB 266 République Gabonaise
Gambia Gambia, Republic of the GM GMB 270 Republic of The Gambia
Georgia Georgia, Republic of GE GEO 268 Sak'art'velo
Germany Germany, Federal Republic of DE DEU 276 Bundesrepublik Deutschland
Ghana Ghana, Republic of GH GHA 288 Republic of Ghana
Gibraltar Gibraltar GI GIB 292 Gibraltar
Greece Hellenic Republic GR GRC 300 Elliniki Dhimokratia
Greenland Greenland GL GRL 304 Kalaallit Nunaat
Grenada Grenada GD GRD 308 Camerhogne
Guadeloupe Guadeloupe, Department of GP GLP 312 Departement de la Guadeloupe
Guam Guam, Territory of GU GUM 316 Territory of Guam
Guatemala Guatemala, Republic of GT GTM 320 República de Guatemala
Guernsey Guernsey, Bailiwick of GG GGY 831 Bailliage de Guernesey
Guinea Guinea, Republic of GN GIN 324 République de Guinee
Guinea-Bissau Guinea-Bissau, Republic of GW GNB 624 República da Guiné-Bissau
Guyana Guyana, Co-operative Republic of GY GUY 328 Co-operative Republic of Guyana
Haiti Haiti, Republic of HT HTI 332 Repiblik Dayti
Honduras Honduras, Republic of HN HND 340 República de Honduras
Hong Kong Hong Kong Special Administrative Region HK HKG 344 Xianggang Tebie Xingzhengqu
Hungary Hungary, Republic of HU HUN 348 Magyar Koztarsaság
Iceland Iceland, Republic of IS ISL 352 Lydhveldidh Island
India India, Republic of IN IND 356 Bharat Ganarajya
Indonesia Indonesia, Republic of ID IDN 360 Republik Indonesia
Iran Iran, Islamic Republic of IR IRN 364 Jomhuri-ye Eslami-ye Iran
Iraq Iraq, Republic of IQ IRQ 368 Al Jumhuriyah al Iraqiyah
Ireland Ireland, Republic of IE IRL 372 Poblacht na héireann
Isle of Man Isle of Man IM IMN 833 Ellan Vannin
Israel Israel, State of IL ISR 376 Medinat Yisra'el
Italy Italian Republic IT ITA 380 Repubblica Italiana
Jamaica Jamaica JM JAM 388 Jamaica
Japan Japan JP JPN 392 Nihon Koku
Jersey Jersey, Bailiwick of JE JEY 832 Bailliage de Jersey
Jordan Jordan, Hashemite Kingdom of JO JOR 400 Al Mamlakah al Urduniyah al Hashimiyah
Kazakhstan Kazakhstan, Republic of KZ KAZ 398 Qazaqstan Respublikasy
Kenya Kenya, Republic of KE KEN 404 Republic of Kenya
Kiribati Kiribati, Republic of KI KIR 296 Republic of Kiribati
Kosovo (UNMIK) Kosovo, Republic of Republic of Kosovo (United Nations Interim Administration Mission in Kosovo)
Kuwait Kuwait, State of KW KWT 414 Dawlat al Kuwayt
Kyrgyzstan Kyrgyz Republic KG KGZ 417 Kyrgyz Respublikasy
Laos Lao People's Democratic Republic (PDR) LA LAO 418 Sathalanalat Paxathipatai Paxaxon Lao
Latvia Latvia, Republic of LV LVA 428 Latvijas Republika
Lebanon Lebanese Republic LB LBN 422 Al Jumhuriyah al Lubnaniyah
Lesotho Lesotho, Kingdom of LS LSO 426 Kingdom of Lesotho
Liberia Liberia, Republic of LR LBR 430 Republic of Liberia
Libya Libya LY LBY 434 Libya
Liechtenstein Liechtenstein, Principality of LI LIE 438 Fürstentum Liechtenstein
Lithuania Lithuania, Republic of LT LTU 440 Lietuvos Respublika
Luxembourg Luxembourg, Grand Duchy of LU LUX 442 Grand-Duché de Luxembourg
Macao Macao Special Administrative Region of the People's Republic of China MO MAC 446 Àomén Tèbié Xíngzhèngqū
Macedonia Macedonia, the former Yugoslav Republic of MK MKD 807 Republika Makedonija
Madagascar Madagascar, Republic of MG MDG 450 Repoblikan'i Madagasikara
Malawi Malawi, Republic of MW MWI 454 Republic of Malawi
Malaysia Malaysia, Federation of MY MYS 458 Persekutuan Malaysia
Maldives Maldives, Republic of MV MDV 462 Dhivehi Raajjeyge Jumhooriyyaa
Mali Mali, Republic of ML MLI 466 République de Mali
Malta Malta, Republic of MT MLT 470 Repubblika ta' Malta
Marshall Islands Marshall Islands, Republic of the MH MHL 584 Aolepan Aorokin Majel
Martinique Martinique, Overseas Department of MQ MTQ 474 Département d'Outre-mer de la Martinique
Mauritania Mauritania, Islamic Republic of MR MRT 478 Al Jumhuriyah al Islamiyah al Muritaniyah
Mauritius Mauritius, Republic of MU MUS 480 République de Maurice
Mayotte Mayotte, Department of YT MYT 175 Département de Mayotte
Mexico United Mexican States MX MEX 484 Estados Unidos Mexicanos
Micronesia Micronesia, Federated States of FM FSM 583 Federated States of Micronesia
Moldova Moldova, Republic of MD MDA 498 Republica Moldova
Monaco Monaco, Principality of MC MCO 492 Principaute de Monaco
Mongolia Mongolia MN MNG 496 Mongol Uls
Montenegro Montenegro ME MNE 499 Crna Gora
Montserrat Montserrat MS MSR 500 Montserrat
Morocco Morocco, Kingdom of MA MAR 504 Al Mamlakah al-Maghribiyah
Mozambique Mozambique, Republic of MZ MOZ 508 República de Moçambique
Myanmar Myanmar, Republic of the Union of MM MMR 104 Pyidaungzu Myanma Naingngandaw
Namibia Namibia, Republic of NA NAM 516 Republic of Namibia
Nauru Nauru, Republic of NR NRU 520 Republik Naoero
Nepal Nepal, Federal Democratic Republic of NP NPL 524 Sanghiya Loktāntrik Ganatantra Nepāl
Netherlands Netherlands, Kingdom of the NL NLD 528 Koninkrijk der Nederlanden
New Caledonia New Caledonia and Dependencies, Territory of NC NCL 540 Territoire des Nouvelle-Calédonie et Dependances
New Zealand New Zealand NZ NZL 554 Aotearoa
Nicaragua Nicaragua, Republic of NI NIC 558 Republica de Nicaragua
Niger Niger, Republic of NE NER 562 Republique du Niger
Nigeria Nigeria, Federal Republic of NG NGA 566 Federal Republic of Nigeria
Niue Niue NU NIU 570 Niuē
Norfolk Island Norfolk Island, Territory of NF NFK 574 Teratri of Norf'k Ailen
North Korea Korea, Democratic People's Republic of KP PRK 408 Democratic People's Republic of Korea
Northern Mariana Islands Northern Mariana Islands, Commonwealth of the MP MNP 580 Commonwealth of the Northern Mariana Islands
Norway Norway, Kingdom of NO NOR 578 Kongeriket Norge
Oman Oman, Sultanate of OM OMN 512 Saltanat Uman
Pakistan Pakistan, Islamic Republic of PK PAK 586 Islami Jamhooriya-e-Pakistan
Palau Palau, Republic of PW PLW 585 Beluu er a Belau
Panama Panama, Republic of PA PAN 591 República de Panamá
Papua New Guinea Papua New Guinea, Independent State of PG PNG 598 Papuaniugini
Paraguay Paraguay, Republic of PY PRY 600 República del Paraguay
Peru Peru, Republic of PE PER 604 República del Perú
Philippines Philippines, Republic of the PH PHL 608 Republika ng Pilipinas
Pitcairn Pitcairn, Henderson, Ducie, and Oeno Islands PN PCN 612 Pitcairn, Henderson, Ducie, and Oeno Islands
Poland Poland, Republic of PL POL 616 Rzeczpospolita Polska
Portugal Portuguese Republic PT PRT 620 República Portuguesa
Puerto Rico Puerto Rico, Commonwealth of PR PRI 630 Estado Libre Asociado de Puerto Rico
Qatar Qatar, State of QA QAT 634 Dawlat Qatar
Reunion Reunion, Department of RE REU 638 Department of Réunion
Romania Romania RO ROU 642 România
Russia Russian Federation RU RUS 643 Rossiyskaya Federatsiya
Rwanda Rwanda, Republic of RW RWA 646 Republika y'u Rwanda
Saint Barthélemy Saint-Barthélemy, Territorial Collectivity of BL BLM 652 Collectivité Territoriale de Saint-Barthélemy
Saint Helena, Ascension and Tristan da Cunha Saint Helena, Ascension and Tristan da Cunha SH SHN 654 Saint Helena, Ascension and Tristan da Cunha
Saint Kitts and Nevis Saint Kitts and Nevis, Federation of KN KNA 659 Federation of Saint Kitts and Nevis
Saint Lucia Saint Lucia LC LCA 662 Hewanorra
Saint Martin (French part) Saint-Martin, Collectivity of MF MAF 663 Collectivité de Saint-Martin
Saint Pierre and Miquelon Saint Pierre and Miquelon, Overseas Collectivity of PM SPM 666 Collectivité d'Outre-mer de Saint-Pierre-et-Miquelon
Saint Vincent and the Grenadines Saint Vincent and the Grenadines VC VCT 670 Saint Vincent and the Grenadines
San Marino San Marino, Republic of SM SMR 674 Serenissima Repubblica di San Marino
Sao Tome and Principe Sao Tome and Principe, Democratic Republic of ST STP 678 República Democrática de São Tomé e Príncipe
Saudi Arabia Saudi Arabia, Kingdom of SA SAU 682 Al-Mamlaka al-Arabiya as-Saudiya
Senegal Senegal, Republic of SN SEN 686 République du Sénégal
Serbia Serbia, Republic of RS SRB 688 Republika Srbija
Seychelles Seychelles, Republic of SC SYC 690 République des Seychelles
Sierra Leone Sierra Leone, Republic of SL SLE 694 Republic of Sierra Leone
Singapore Singapore, Republic of SG SGP 702 Republik Singapura
Sint Maarten (Dutch part) Sint Maarten SX SXM 534 Sint Maarten
Slovakia Slovak Republic SK SVK 703 Slovenska Republika
Slovenia Slovenia, Republic of SI SVN 705 Republika Slovenija
Solomon Islands Solomon Islands SB SLB 90 Solomon Islands
Somalia Somali Republic SO SOM 706 Somali Republic
South Africa South Africa, Republic of ZA ZAF 710 Republiek van Suid-Afrika
South Georgia and the South Sandwich Islands South Georgia and the South Sandwich Islands GS SGS 239 South Georgia and the South Sandwich Islands
South Korea Korea, Republic of KR KOR 410 Taehan-min'guk
South Sudan South Sudan, Republic of SS SSD 728 Republic of South Sudan
Spain Spain, Kingdom of ES ESP 724 Reino de España
Sri Lanka Sri Lanka, Socialist Republic of LK LKA 144 Ilankai
Sudan Sudan, Republic of the SD SDN 729 Jumhuriyat as-Sudan
Suriname Suriname, Republic of SR SUR 740 Republiek Suriname
Svalbard and Jan Mayen Svalbard and Jan Mayen SJ SJM 744 Svalbard og Jan Mayen
Swaziland Swaziland, Kingdom of SZ SWZ 748 Umbuso weSwatini
Sweden Sweden, Kingdom of SE SWE 752 Konungariket Sverige
Switzerland Swiss Confederation CH CHE 756 Schweizerische Eidgenossenschaft
Syria Syrian Arab Republic SY SYR 760 Al Jumhuriyah al Arabiyah as Suriyah
Taiwan Taiwan, Province of China TW TWN 158 T'ai-wan
Tajikistan Tajikistan, Republic of TJ TJK 762 Jumhurii Tojikiston
Tanzania Tanzania, United Republic of TZ TZA 834 Jamhuri ya Muungano wa Tanzania
Thailand Thailand, Kingdom of TH THA 764 Muang T'hai - Prathet T'hai
Timor-Leste Timor-Leste, Democratic Republic of TL TLS 626 Republika Demokratika Timor Loro Sa'e
Togo Togo, Republic of TG TGO 768 République Togolaise
Tokelau Tokelau TK TKL 772 Tokelau
Tonga Tonga, Kingdom of TO TON 776 Kingdom of Tonga
Trinidad and Tobago Trinidad and Tobago, Republic of TT TTO 780 Republic of Trinidad and Tobago
Tunisia Tunisian Republic TN TUN 788 Al Jumhuriyah at Tunisiyah
Turkey Turkey, Republic of TR TUR 792 Türkiye Cumhuriyeti
Turkmenistan Turkmenistan TM TKM 795 Turkmenistan
Turks and Caicos Islands Turks and Caicos Islands TC TCA 796 Turks and Caicos Islands
Tuvalu Tuvalu TV TUV 798 Tuvalu
Uganda Uganda, Republic of UG UGA 800 Republic of Uganda
Ukraine Ukraine UA UKR 804 Ukrayina
United Arab Emirates United Arab Emirates AE ARE 784 Dawlat Al Amarat al Arabiyah al Muttahidah
United Kingdom Great Britain and Northern Ireland, United Kingdom of GB GBR 826 United Kingdom of Great Britain and Northern Ireland
United States America, United States of US USA 840 United States of America
Uruguay Uruguay, Eastern Republic of UY URY 858 República Oriental del Uruguay
Uzbekistan Uzbekistan, Republic of UZ UZB 860 Ozbekiston Respublikasi
Vanuatu Vanuatu, Republic of VU VUT 548 Republic of Vanuatu
Vatican City (Holy See) Vatican City, State of the VA VAT 336 Status Civitatis Vaticanæ
Venezuela Venezuela, Bolivarian Republic of VE VEN 862 República Bolivariana de Venezuela
Viet Nam Vietnam, Socialist Republic of VN VNM 704 Cộng hòa xã hội chủ nghĩa Việt Nam
Virgin Islands Virgin Islands, United States VI VIR 850 United States Virgin Islands
Wallis and Futuna Wallis and Futuna Islands, Territory of the WF WLF 876 Territoire des îles Wallis-et-Futuna
Western Sahara Western Sahara EH ESH 732 aṣ-Ṣaḥrā’ al-Gharbīyah
Western Samoa Samoa, Independent State of WS WSM 882 Malotuto'atasi o Samoa
Yemen Yemen, Republic of YE YEM 887 Al Jumhuriyah al Yamaniyah
Zambia Zambia, Republic of ZM ZMB 894 Republic of Zambia
Zimbabwe Zimbabwe, Republic of ZW ZWE 716 Republic of Zimbabwe
Åland Islands Åland Islands AX ALA 248 Landskapet Åland