International Address Submission Best Practices

It is important to follow ISO standard formats and logical country-state correspondences when submitting an international address via the API to ensure accurate geocoding and delivery.

📘

Note:

• Electronic Know Your Customer (eKYC) services for international address verification in Australia, China, Hong Kong, and New Zealand require additional provisioning and may incur extra costs. To enable eKYC international verification for your account, complete the following steps:

  • Contact Socure support to inquire about enabling and provisioning eKYC services on your account.

  • Review and accept any additional terms of service for the eKYC international address verification product.

  • Provide any requested information to complete the provisioning process.

  • eKYC services will only function on your account once the provisioning process is complete.

• For international verification in Australia, China, Hong Kong, and New Zealand, please fill out a sub processor form.

Country codes

The country code must be a valid ISO 3166-1 alpha-2 code. For example:

• US for United States

• CA for Canada

• GB for United Kingdom

• FR for France

• MX for Mexico

State and province codes

State and province codes should only be submitted for countries where they are officially defined and used for mail delivery. They must be in ISO 3166-2 format. Below are some examples:

• US addresses should include the complete state code. For example, CA for California, TX for Texas.

• Canadian addresses should include the two-letter province code. For example, ON for Ontario, BC for British Columbia.

• UK addresses should not include a state or province code since the UK does not use them for mail delivery.

• Mexican addresses should include the uppercase three-letter province code. For example, JAL for Jalisco, SLP for San Luis Potosi.

Non-ISO state and province names

Some countries utilize non-ISO standards for state and province codes in mailing addresses. Below are some examples:

• For Austrian addresses, use the numerical state code instead of the state name. For example, use "9" for Wien, Austria.

• For Ecuadorian addresses, use the state code lettering (usually a single character) instead of the state name. For example, use "T" for Tungurahua, Ecuador.

Putting it all together

Below are some example requests that meet ISO standard formats for international addresses.

{
  "id": "au-verify-001",
  "timestamp": "2026-04-08T00:00:00Z",
  "workflow": "verify_kyc",
  "data": {
    "individual": {
      "given_name": "Ava",
      "family_name": "Brown",
      "date_of_birth": "1984-05-17",
      "national_id": "PA0940443",
      "phone_number": "+614123456789",
      "address": {
        "line_1": "200 Broadway Av",
        "locality": "West Beach",
        "major_admin_division": "SA",
        "postal_code": "5024",
        "country": "AU"
      }
    }
  }
}