Locations: Parse International Address

Use this action to verify an international address and save each portion into a standardized format.

This is a premium action. By default, a premium action is not available in a team as there is an additional fee associated with it. Please contact Catalytic Support to begin working with this action, or check the Premium Actions article.

Use Case

Convert an addressed entered by a user into one field into its components prior to creating a customer record in an integrated system

How to configure this action

Fields for this action

  • Street address

    • Reference the field in {{field-name}} format that contains the address you are trying to parse
  • Country

  • Return field name

    • Name the field to store the action’s output. The output field can be referenced

What will this output?

The expected output for this action is the parsed result of the address stored in the return field name defined in configuration. The field will be a JSON field with the structured address.

If the address can be parsed, the JSON will follow this format:

  {

  "address-1": "42A Torbrex Road",
  "address-2": "Stirling",
  "address-3": "FK7 9HH",
  "country": "UK",
  "status": "completed",
  "street-address": "42A Torbrex Road, Stirling, FK7 9HH, UK",
  "administrative-area": "Stirlingshire",
  "country-iso-3": "GBR",
  "locality": "Stirling",
  "postal-code": "FK7 9HH",
  "postal-code-short": "FK7 9HH",
  "premise": "42A",
  "premise-number": "42A",
  "thoroughfare": "Torbrex Road",
  "thoroughfare-name": "Torbrex",
  "thoroughfare-trailing-type": "Road"
  }

If the address could not be parsed, the JSON will follow this format:

  {
  "address-verified": false,
  "status": "failed"
  }

Tips

  • Use the Field: Field formulas action to convert the JSON into separate fields
  • If you’re not able to find the country, try running this action multiple times with different countries until the address is successfully parsed.
  • Build logic into your process so that when the address cannot be parsed, a task is assigned to a user to manually parse the address.

Supported Countries

A list of all supported countries is listed below. This is useful to copy and paste into a Single Choice field:

  Afghanistan
  Åland Islands
  Albania
  Algeria
  American Samoa
  Andorra
  Angola
  Anguilla
  Antarctica
  Antigua Barbuda
  Argentina
  Armenia
  Aruba
  Australia
  Austria
  Azerbaijan
  Bahamas
  Bahrain
  Bangladesh
  Barbados
  Belarus
  Belgium
  Belize
  Benin
  Bermuda
  Bhutan
  Bolivia
  Bonaire
  Bosnia Herzegovina
  Botswana
  Brazil
  British Indian Ocean Territory
  British Virgin Islands
  Brunei Darussalam
  Bulgaria
  Burkina Faso
  Burundi
  Cambodia
  Cameroon
  Canada
  Cape Verde Islands
  Cayman Islands
  Central African Republic
  Chad
  Chile
  China
  Christmas Island
  Cocos (Keeling) Islands
  Colombia
  Comoros
  Congo
  Cook Islands
  Costa Rica
  Croatia
  Cuba
  Curacao
  Cyprus
  Czech Republic
  Denmark
  Djibouti
  Dominica
  Dominican Republic
  Ecuador
  Egypt
  El Salvador
  Equatorial Guinea
  Eritrea
  Estonia
  Ethiopia
  Falkland Islands
  Faroe Islands
  Fiji
  Finland
  France
  French Guiana
  French Polynesia
  French Southern Territories
  Gabon
  Gambia
  Georgia
  Germany
  Ghana
  Gibraltar
  Greece
  Greenland
  Grenada
  Guadeloupe
  Guam
  Guatemala
  Guernsey
  Guinea
  Guinea-Bissau
  Guyana
  Haiti
  Holy See
  Honduras
  Hong Kong
  Hungary
  Iceland
  India
  Indonesia
  Iran
  Iraq
  Ireland
  Isle of Man
  Israel
  Italy
  Ivory Coast
  Jamaica
  Japan
  Jersey
  Jordan
  Kazakhstan
  Kenya
  Kiribati
  Korea
  Kuwait
  Kyrgyzstan
  Laos
  Latvia
  Lebanon
  Lesotho
  Liberia
  Libya
  Liechtenstein
  Lithuania
  Luxembourg
  Macao
  Macedonia
  Madagascar
  Malawi
  Malaysia
  Maldives
  Mali
  Malta
  Marshall Islands
  Martinique
  Mauritania
  Mauritius
  Mayotte
  Mexico
  Micronesia
  Moldova
  Monaco
  Mongolia
  Montenegro
  Montserrat
  Morocco
  Mozambique
  Myanmar
  Namibia
  Nauru
  Nepal
  Netherlands Antilles
  Netherlands
  New Caledonia
  New Zealand
  Nicaragua
  Niger
  Nigeria
  Niue
  Norfolk Island
  North Korea
  Northern Mariana Islands
  Norway
  Oman
  Pakistan
  Palau
  Palestinian Territory
  Panama
  Papua New Guinea
  Paraguay
  Peru
  Philippines
  Pitcairn Island
  Poland
  Portugal
  Puerto Rico
  Qatar
  Réunion
  Romania
  Russia
  Rwanda
  Saint Barthélemy
  Saint Helena
  Saint Kitts and Nevis
  Saint Lucia
  Saint Martin
  Saint Pierre and Miquelon
  Saint Vincent and the Grenadines
  Samoa
  San Marino
  Sao Tome and Principe
  Saudi Arabia
  Senegal
  Serbia
  Seychelles
  Sierra Leone
  Singapore
  Sint Maarten (Dutch)
  Slovakia
  Slovenia
  Solomon Islands
  Somalia
  South Africa
  South Georgia and the South Sandwich Islands
  South Sudan
  Spain
  Sri Lanka
  Sudan
  Suriname
  Svalbard and Jan Mayen Islands
  Swaziland
  Sweden
  Switzerland
  Syria
  Taiwan
  Tajikistan
  Tanzania
  Thailand
  Timor-Leste (formerly East Timor)
  Togo
  Tokelau
  Tonga
  Trinidad and Tobago
  Tunisia
  Turkey
  Turkmenistan
  Turks and Caicos Islands
  Tuvalu
  Uganda
  Ukraine
  United Arab Emirates
  United Kingdom
  United States Minor Outlying Islands
  United States Virgin Islands
  United States
  Uruguay
  Uzbekistan
  Vanuatu
  Venezuela
  Vietnam
  Wallis and Futuna Islands
  Western Sahara
  Yemen
  Zambia
  Zimbabwe

Sorry about that. What was the most unhelpful part?









Thanks for your feedback

We update the Help Center daily, so expect changes soon.

Link Copied

Paste this URL anywhere to link straight to the section.

Need more help?

If you're signed in to Catalytic Community, you can ask other users a question. You'll be redirected to Community where you can add more info.