Verify International Addresses

international address verification

This page describes how to verify an international address using Smarty's (formerly SmartyStreets) international address verification API. (View current pricing.)

Contents

  1. HTTP Request
    1. URL Composition
    2. Request Methods
    3. Headers
    4. Input Fields
  2. HTTP Response
    1. Status Codes and Results
    2. Output field definitions
  3. Supplementary Material
    1. Full Examples
    2. Supported Countries
    3. SSL/TLS Information
    4. Try the demo

HTTP Request: URL Composition

Proper URL construction is required for all API requests. Here is an example URL:

https://international-street.api.smartystreets.com/verify?auth-id=123&auth-token=abc

URL Components:

  • Scheme: https
    (Required; non-secure http requests are not supported.)
  • Hostname: international-street.api.smartystreets.com
  • Path: /verify
  • Query String: ?auth-id=123&auth-token=abc
    (Additional query string parameters are required; consult the next section.)

For additional information, please read our article about URL components.

HTTP Request: Supported Methods/Verbs

HTTP requests can be categorized according to their HTTP method. Most HTTP requests are defined using the GET method. We call these "get requests." Other common methods are PUT, POST, and DELETE.

The following methods are supported by this API:

HTTP GET

To send one (and only one) address to our API, simply encode the input field names from the table below along with the corresponding input values as query string parameters in the URL of your request. Here's an example that uses the address1, address2, locality, administrative_area, postal_code, and country fields:

curl -v 'https://international-street.api.smartystreets.com/verify?
	auth-id=YOUR+AUTH-ID+HERE&
	auth-token=YOUR+AUTH-TOKEN+HERE&

	address1=Rua+Padre+Antonio+D%27Angelo+121&
	address2=Casa+Verde&
	locality=Sao+Paulo&
	administrative_area=SP&
	postal_code=02516-040&
	country=Brazil'

Please note that all query string parameter values must be url-encoded (spaces become + or %20, for example) to ensure that the data is transferred correctly. A common mistake we see is a non-encoded pound sign (#) like in an apartment number (# 409). This character, when properly encoded in a URL, becomes %23. When not encoded this character functions as the fragment identifier, which is ignored by our API servers.

HTTP Request: Headers

You must include the following required HTTP headers in all requests:

Host The Host request header field specifies the internet host and port number of the resource being requested Host: international-street.api.smartystreets.com

Input Fields

Each address submitted must have non-blank values for one of the following field combinations to be processed:

  • country + freeform
  • country + address1 + postal_code
  • country + address1 + locality + administrative_area

The ideal combination of input fields, which has the best chance of finding a valid address match, is as follows:

country + address1 + locality + administrative_area + postal_code

Additionally, the address1 field should contain the thoroughfare (street) name and the premise number. Example: 200 River Terrace

Name Type Max Characters Description
input_id string 36 A unique identifier generated by you for this address for use within your application; this field will be copied into the output.
(e.g., 123456)
country string 64 (required) This must be entered with every address. Country Name or ISO classification (ISO-3, ISO-2 or ISO-N). Address validation will fail if this is missing.
(e.g., Brazil, BRA, BR, or 076)
geocode string 4 Set to true to enable geocoding (disabled by default). See the examples section for, well, an example.
language string 6 When not set, the output language will match the language of the input values. When set to native, the results will always be in the language of the output country whenever possible. When set to latin, the results will always be provided using a Latin character set basic ASCII, accents and other diacritics removed. The following character sets can be transliterated, into either native or Latin characters, for the specified countries:
  • Russian (Kazakhstan, Azerbaijan)
  • Japanese (Japan)
  • Simplified Chinese (China)
  • Thai (Thailand)
  • Arabic (Algeria, Bahrain, Egypt, Iraq, Jordan, Kuwait, Lebanon, Morocco, Oman, Qatar, Saudi Arabia, United Arab Emirates, Yemen)
freeform string 512 The entire address in a single field (without the country). If freeform is specified, all other address input fields (except country) will be ignored.
(e.g., Via Santa Maria di Costantinopoli, 72 46030-Tabellano MN)
address1 string 64 The first address line
(e.g., Calle Proc. San Sebastián, 15)
address2 string 64 The second address line (if any)
address3 string 64 The third address line (if any)
address4 string 64 The fourth address line (if any)
organization string 64 The name of the recipient, firm, or company at this address
(e.g., Robert Smith OR The Clean Oil Company)
locality string 64 The city name
(e.g., Paris)
administrative_area string 32 The state or province name or abbreviation
(e.g., Alberta or AB)
postal_code string 16 The postal code
(e.g., 90210-2301)
license string 64 The license or licenses (comma separated) to use for this lookup. Valid values can be found in the account dashboard under the appropriate subscription. If multiple licenses are specified, they are considered in left to right order. We recommend that each request explicitly specify a license value. For more information see License Selection.

HTTP Response: Status Codes and Results

Responses will have a status header with a numeric value. This value is what you should check for when writing code to parse the response. The only response body that should be read and parsed is a 200 response.

Status Code Response and Explanation
401 Unauthorized: The credentials were provided incorrectly or did not match any existing, active credentials.
402 Payment Required: There is no active subscription for the account associated with the credentials submitted with the request.
403 Forbidden: Because the international service is currently in a limited release phase, only approved accounts may access the service. Please contact us for your account to be granted access.
400 Bad Request (Malformed Payload): Inputs from the request could not be interpreted.
422 Unprocessable Entity: A GET request lacked required fields.
429 Too Many Requests: Too many requests with exactly the same input values were submitted within too short a period. This status code conveys that the input was not processed in order to prevent runaway charges caused by such conditions as a misbehaving (infinite) loop sending the same record over and over to the API. You're welcome.
429 (again) Too Many Requests: When using public "embedded key" authentication, we restrict the number of requests coming from a given source over too short of a time. If you use embedded key authentication, you can avoid this error by adding your IP address as an authorized host for the embedded key in question.
504 Gateway Timeout: Our own upstream data provider did not respond in a timely fashion and the request failed. A serious, yet rare occurrence indeed.
200 OK (success!): A JSON array containing zero or more address matches for the input provided with the request. If none of the submitted addresses validate, the array will be empty ([]).

Full Example: Verify Only (No Geocodes)

Request

curl -v 'https://international-street.api.smartystreets.com/verify?
	auth-id=YOUR+AUTH-ID+HERE&
	auth-token=YOUR+AUTH-TOKEN+HERE&

	address1=Rua+Padre+Antonio+D%27Angelo+121&
	address2=Casa+Verde&
	locality=Sao+Paulo&
	administrative_area=SP&
	postal_code=02516-040&
	country=Brazil'

Response

Every response is a JSON array containing zero or more address matches for your input. Only non-blank fields will be returned.

[
	{
		"address1":"Rua Padre Antônio D'ângelo 121",
		"address2":"Casa Verde",
		"address3":"02516-040 São Paulo SP",
		"components":{
			"administrative_area":"SP",
			"dependent_locality":"Casa Verde",
			"country_iso_3":"BRA",
			"locality":"São Paulo",
			"postal_code":"02516-040",
			"postal_code_short":"02516-040",
			"premise":"121",
			"premise_number":"121",
			"thoroughfare":"Rua Padre Antônio D'ângelo",
			"thoroughfare_name":"Padre Antonio D'angelo",
			"thoroughfare_type":"Rua"
		},
		"metadata":{

		},
		"analysis":{
			"verification_status":"Verified",
			"address_precision":"Premise"
		}
	}
]

Full Example: Verify + Geocode

Request

curl -v 'https://international-street.api.smartystreets.com/verify?
	auth-id=YOUR+AUTH-ID+HERE&
	auth-token=YOUR+AUTH-TOKEN+HERE&

	address1=Rua+Padre+Antonio+D%27Angelo+121&
	address2=Casa+Verde&
	locality=Sao+Paulo&
	administrative_area=SP&
	postal_code=02516-040&
	country=Brazil&
	geocode=true'

Response

Every response is a JSON array containing zero or more address matches for your input.

[
	{
		"address1":"Rua Padre Antônio D'ângelo 121",
		"address2":"Casa Verde",
		"address3":"02516-040 São Paulo SP",
		"components":{
			"administrative_area":"SP",
			"dependent_locality":"Casa Verde",
			"country_iso_3":"BRA",
			"locality":"São Paulo",
			"postal_code":"02516-040",
			"postal_code_short":"02516-040",
			"premise":"121",
			"premise_number":"121",
			"thoroughfare":"Rua Padre Antônio D'ângelo",
			"thoroughfare_name":"Padre Antonio D'angelo",
			"thoroughfare_type":"Rua"
		},
		"metadata":{
			"latitude":-23.50948,
			"longitude":-46.66073,
			"geocode_precision":"Premise"
		},
		"analysis":{
			"verification_status":"Verified",
			"address_precision":"Premise"
		}
	}
]

Output Fields

NOTE: Any returned fields that are not defined within this document should be considered experimental and may be changed or discontinued at any time without notice.

Root | Components | Metadata | Analysis | Changes

Root

Field Name Type Definition
input_id varchar(16) A unique identifier generated by you for this address for use within your application. The output will be identical to the value you provided in the request input_id.
organization varchar(256) The name of the recipient, firm, or company at this address. The output will be identical to the input.
address1-12 varchar(256) If address_precision = DeliveryPoint or Premise, these fields will contain the correctly formatted address for mailing in the relevant country, split into individual address lines. (Note: These fields may contain values that are not referenced in the address components.)

If address_precisionDeliveryPoint or Premise, the address fields may contain standardized address information or even the original input data.
components [Object] See "Components" table below. Contains the various basic elements of the address.
metadata [Object] See "Metadata" table below. Contains ancillary data about each address.
analysis [Object] See "Analysis" table below. Contains information about the validation and the precision of the output address.

Components

Field Name Type Definition
country_iso_3 varchar(3) The ISO 3166-1 alpha-3 country code. See our full listing for details.
administrative_area varchar(64) The most common administrative division within a country
(e.g., province in Canada)
super_administrative_area varchar(64) The largest administrative division within a country
(e.g., region in France)
sub_administrative_area varchar(64) The smallest administrative division within a country
(e.g., county in Germany)
locality varchar(64) Within a country, this is the most common population center.
(e.g., city in Chile)
dependent_locality varchar(64) If there is additional information about the locality, it will be here.
(e.g., neighborhood in Turkey)
dependent_locality_name varchar(64) If the dependent_locality has a name, you'll find it here.
(E.g., the dependent_locality "Dong Cheng Qu" is named "Dong Cheng.")
double_dependent_locality varchar(64) If there is additional information about the dependent_locality, you'll find it here.
(e.g., village in the United Kingdom)
postal_code varchar(64) The complete postal code for the delivery point
(e.g., V6G1V9 in Canada)
postal_code_short varchar(64) Primary postal code information
(e.g., 90210 in the United States)
postal_code_extra varchar(64) Secondary postal code information
(e.g., 3425 in the United States)
premise varchar(64) Alphanumeric code pertaining to an individual location
premise_extra varchar(64) Extra information about the premise that is not necessarily authoritative but might still be useful
(E.g., in a French address, 25 bis rue Emile Zola, 91190 Gif Sur Yvette, France, the premise number could be followed by the word "bis" which would be considered premise_extra data.)
premise_number varchar(64) The alphanumeric component of the premise field
(E.g., if premise contains "Plot 7/7A" premise_number would contain "7/7A.")
premise_type varchar(64) The premise type component of the premise field
(E.g., if premise contains "Plot 7/7A" premise_type would contain "Plot.")
thoroughfare varchar(64) All thoroughfare components combined
thoroughfare_predirection varchar(64) The directional prefix component of the thoroughfare
(E.g., if thoroughfare contains "N Main St" thoroughfare_predirection would contain "N."
thoroughfare_postdirection varchar(64) The directional suffix component of the thoroughfare
(E.g., if thoroughfare contains "Main St N" thoroughfare_postdirection would contain "N.")
thoroughfare_name varchar(64) The name component of the thoroughfare
(E.g., if thoroughfare contains "Main St" thoroughfare_name would contain "Main.")
thoroughfare_trailing_type varchar(64) The trailing thoroughfare type component of the thoroughfare
(E.g., if thoroughfare contains "N Main St" thoroughfare_trailing_type would contain "St.")
thoroughfare_type varchar(64) The leading thoroughfare type component of the thoroughfare
(E.g., if thoroughfare contains "Rue De La Gare" thoroughfare_leading_type would contain "Rue.")
dependent_thoroughfare varchar(64) All of the dependent thoroughfare components combined
dependent_thoroughfare_predirection varchar(64) The directional prefix component of the dependent_thoroughfare
(E.g., if dependent_thoroughfare contains "N Main St" dependent_thoroughfare_predirection would contain "N.")
dependent_thoroughfare_postdirection varchar(64) The directional suffix component of the dependent_thoroughfare
(E.g., if dependent_thoroughfare contains "Main St N" dependent_thoroughfare_postdirection would contain "N.")
dependent_thoroughfare_name varchar(64) The name component of the dependent_thoroughfare
(E.g., if dependent_thoroughfare contains "N Main St" dependent_thoroughfare_name would contain "Main.")
dependent_thoroughfare_trailing_type varchar(64) The trailing dependent_thoroughfare type component of the dependent_thoroughfare
(E.g., if dependent_thoroughfare contains "N Main St" dependent_thoroughfare_trailing_type would contain "St.")
dependent_thoroughfare_type varchar(64) The leading thoroughfare type component of the dependent_thoroughfare field
(E.g., if dependent_thoroughfare contains "Rue De La Gare" dependent_thoroughfare_type would contain "Rue.")
building varchar(64) The descriptive name that identifies an individual location, if one exists
building_leading_type varchar(64) The leading building type component of the building
(E.g., if building contains "Bloc C" building_leading_type would contain "Bloc.")
building_name varchar(64) The name component of the building
(E.g., if building contains "Westminster House" building_name would contain "Westminster.")
building_trailing_type varchar(64) The trailing building type component of the building
(E.g., if building contains "Westminster House" building_trailing_type would contain "House.")
sub_building varchar(64) All sub_building components combined
sub_building_type varchar(64) The leading sub-building type of the sub_building
(E.g., if sub_building contains "Flat 1" sub_building_type would contain "Flat.")
sub_building_number varchar(64) The alphanumeric component of the sub_building
(E.g., if sub_building contains "Flat 1" sub_building_number would contain "1.")
sub_building_name varchar(64) The descriptive name component of the sub_building
(E.g., if sub_building contains "Basement Flat" sub_building_name would contain "Basement.")
post_box varchar(64) All post_box Post Office Box components combined
post_box_type varchar(64) The type component of the post_box
(E.g., if post_box contains "PO Box 1234" post_box_type would contain "PO Box.")
post_box_number varchar(64) The alphanumeric component of the postbox
(E.g., if post_box contains "PO Box 1234" post_box_number would contain "1234.")

Metadata

Field Name Type Definition
latitude decimal(9,6) The horizontal component used for geographic positioning; it is the angle between 0° (the equator) and ±90° (north or south) at the poles measured in decimal degrees. It is the first value in an ordered pair of latitude, longitude. A negative number denotes a location south of the equator; a positive number is north. Combining lat/long values enables you to pinpoint addresses on a map.
longitude decimal(9,6) The vertical component used for geographic positioning; it is the angle between 0° (the Prime Meridian) and ±180° (westward or eastward) measured in decimal degrees. It is the second number in an ordered pair of (latitude, longitude). A negative number indicates a location west of Greenwich, England; a positive number east. Combining lat/long values enables you to pinpoint addresses on a map.
geocode_precision varchar(18) Indicates the precision level of the latitude and longitude values.

None — Geocode not known (possibly because address is invalid).

AdministrativeArea — Geocode is accurate down to the administrative area (i.e., region or province).

Locality — Geocode is accurate down to the locality (i.e., city).

Thoroughfare — Geocode is accurate down to the thoroughfare (i.e., street).

Premise — Geocode is accurate down to a range of addresses on the specified street (i.e., building, block level or street segment).

DeliveryPoint — Geocode is accurate to the actual delivery point (i.e., house, mailbox or apartment).
max_geocode_precision varchar(16) Indicates the best geocode_precision available for the input country.
address_format varchar(256)

A template that shows where we positioned the different address components on line 1, line 2, etc. (The format changes from one country to another.)

Due to the ever-changing nature of the underlying data, this field may contain values that are not referenced in the address components.

Example:

building | premise thoroughfare | postal_code locality

Each "pipe" character (|) represents a line break. Following this guide, the numbered address fields would be composed accordingly:

  • Address 1: building
  • Address 2: premise thoroughfare
  • Address 3: postal_code locality

For native languages that do not use spaces between words, the corresponding component fields will also not have spaces between them.

The address_format field will not be present for US addresses. Here's some additional info on the composition of US addresses.

Analysis

Field Name Type Definition
verification_status varchar(16) Indicates the verification status of the address. (See address_precision for more details)

None — Not verified. The output fields will contain the input data.

Partial — Verification only at the level indicated by address_precision. (Better input might result in a better match.)

Ambiguous — Multiple matching addresses found. Each candidate address will have its own precision level. A common "ambiguous" scenario is that the output will contain two versions of the same address — one with an organization name and one without.

Verified — The address was verified, at the indicated precision level.
address_precision varchar(24) Indicates the precision level at which an address match is found.

None — None of the address is verified.

AdministrativeArea — Address match is verified to the administrative area (i.e., region or province).

Locality — Address match is verified to the locality (i.e., city).

Thoroughfare — Address match is verified down to the thoroughfare (i.e., street).

Premise — Address match is verified to a range of addresses on the specified street (i.e., building, block level or street segment).

DeliveryPoint — Address match is verified to the delivery point (i.e., building, sub-building, or mailbox)
max_address_precision varchar(16) Indicates the best address_precision available for the input country.
changes [Object] Contains a collection of address components paired with values which specify the difference between corresponding input/lookup and output/candidate data. See the explanation of possible Changes values below.

Changes

Each value in this object (and any subordinate objects) will have a type of varchar(64) and will either be blank or contain one of the following values:

Verified-NoChange
Field has been verified using relevant reference data; no changes were needed.
Verified-AliasChange
Field has been verified using relevant reference data; an alias change was made during parsing (see Identified-AliasChange).
Verified-SmallChange
Field has been verified using relevant reference data; a small spelling change was made.
Verified-LargeChange
Field has been verified using relevant reference data; a large spelling change was made.
Added
Field has been added using relevant reference data.
Identified-NoChange
Field has been identified using relevant lexicon data; no changes were needed. E.g., an input value of 'PO Box 1234' may be identifiable as a postbox, but if it is unable to be verified then this value will be returned.
Identified-AliasChange
Field has been identified using relevant lexicon data; an alias change was made. E.g., an input value of 'Avnue' may be identifiable as an alias to the thoroughfare_type 'Ave'.
Identified-ContextChange
Field has been identified using relevant context rules. E.g., an input address of '123 sdovnsdv San Bruno CA USA' may identify the word 'sdovnsdv' as a thoroughfare, but only because of the context in which it appears (after an identifiable premise_number, and before an identifiable locality).
Unrecognized
Field was unrecognized.
Field Name Type Definition
organization varchar(256) If present, the degree of change to the name of the recipient, firm, or company at this address.
address1-12 varchar(256) If present, these fields show the degree of change to each of the address lines.
components [Object] See "Components" table above for field names. However, values will show the degree of change to each of the components of the address.

Supported Countries

The below countries are supported and available in our international address validation. Notice that the verification and geocode accuracy levels are different for each country. That means that addresses in Nicaragua, for example, can only be verified to the locality or city because that is the best data available for that country.

Note: Smarty recommends that any USA address be processed through our us-street-address-api, as the response will contain more useful metadata.

Country ISO-3 ISO-2 Address Precision Geocode Precision
Afghanistan AFG AF Locality Locality
Åland Islands ALA AX Locality Locality
Albania ALB AL Premise Thoroughfare
Alderaan - (No longer available) ALD AA DeliveryPoint DeliveryPoint
Algeria DZA DZ Premise Premise
American Samoa ASM AS DeliveryPoint Premise
Andorra AND AD DeliveryPoint DeliveryPoint
Angola AGO AO Premise Thoroughfare
Anguilla AIA AI Locality Locality
Antarctica ATA AQ AdministrativeArea Locality
Antigua and Barbuda ATG AG Premise Locality
Argentina ARG AR DeliveryPoint DeliveryPoint
Armenia ARM AM Locality Locality
Aruba ABW AW Premise Thoroughfare
Australia AUS AU DeliveryPoint DeliveryPoint
Austria AUT AT DeliveryPoint DeliveryPoint
Azerbaijan AZE AZ Locality Locality
Bahamas BHS BS Premise Thoroughfare
Bahrain BHR BH DeliveryPoint DeliveryPoint
Bangladesh BGD BD Locality Locality
Barbados BRB BB Premise Thoroughfare
Belarus BLR BY Premise Premise
Belgium BEL BE DeliveryPoint DeliveryPoint
Belize BLZ BZ Premise Thoroughfare
Benin BEN BJ Thoroughfare Thoroughfare
Bermuda BMU BM Premise Thoroughfare
Bhutan BTN BT Locality Locality
Bolivarian Republic of Venezuela VEN VE Premise Thoroughfare
Bolivia BOL BO Premise Premise
Bonaire, Sint Eustatius and Saba BES BQ Thoroughfare Thoroughfare
Bosnia and Herzegovina BIH BA Premise Premise
Botswana BWA BW Premise Thoroughfare
Brazil BRA BR DeliveryPoint DeliveryPoint
British Indian Ocean Territory IOT IO AdministrativeArea Locality
British Virgin Islands VGB VG Locality Locality
Brunei Darussalam BRN BN Premise Thoroughfare
Bulgaria BGR BG DeliveryPoint DeliveryPoint
Burkina Faso BFA BF Locality Locality
Burundi BDI BI Locality Locality
Cabo Verde CPV CV Locality Locality
Cambodia KHM KH Locality Locality
Cameroon CMR CM Thoroughfare Thoroughfare
Canada CAN CA DeliveryPoint DeliveryPoint
Cayman Islands CYM KY Locality Locality
Central African Republic CAF CF Locality Locality
Chad TCD TD Locality Locality
Chile CHL CL DeliveryPoint DeliveryPoint
China CHN CN Premise Thoroughfare
Christmas Island CXR CX Locality Locality
Cocos (Keeling) Islands CCK CC DeliveryPoint Locality
Colombia COL CO DeliveryPoint DeliveryPoint
Comoros COM KM Locality Locality
Congo COG CG Locality Locality
Cook Islands COK CK Locality Locality
Costa Rica CRI CR Premise Premise
Croatia HRV HR DeliveryPoint DeliveryPoint
Cuba CUB CU Locality Locality
Curaçao CUW CW Locality Locality
Cyprus CYP CY Premise Premise
Czechia CZE CZ DeliveryPoint DeliveryPoint
Democratic People's Republic of Korea (North Korea) PRK KP Locality Locality
Democratic Republic of the Congo COD CD Premise Thoroughfare
Denmark DNK DK DeliveryPoint DeliveryPoint
Djibouti DJI DJ Locality Locality
Dominica DMA DM Locality Locality
Dominican Republic DOM DO Premise Thoroughfare
Ecuador ECU EC Premise Premise
Egypt EGY EG DeliveryPoint DeliveryPoint
El Salvador SLV SV Premise Thoroughfare
Equatorial Guinea GNQ GQ Locality Locality
Eritrea ERI ER Locality Locality
Estonia EST EE DeliveryPoint DeliveryPoint
Eswatini SWZ SZ Premise Thoroughfare
Ethiopia ETH ET Locality Locality
Falkland Islands FLK FK Locality Locality
Faroe Islands FRO FO Locality Locality
Federated States of Micronesia FSM FM AdministrativeArea Locality
Fiji FJI FJ Locality Locality
Finland FIN FI Premise Premise
France FRA FR DeliveryPoint DeliveryPoint
French Guiana GUF GF DeliveryPoint DeliveryPoint
French Polynesia PYF PF Locality Locality
French Southern Territories ATF TF AdministrativeArea Locality
Gabon GAB GA Thoroughfare Locality
Gambia GMB GM Locality Locality
Georgia GEO GE DeliveryPoint DeliveryPoint
Germany DEU DE DeliveryPoint DeliveryPoint
Ghana GHA GH Premise Thoroughfare
Gibraltar GIB GI DeliveryPoint DeliveryPoint
Greece GRC GR DeliveryPoint DeliveryPoint
Greenland GRL GL Locality Locality
Grenada GRD GD Locality Locality
Guadeloupe GLP GP DeliveryPoint DeliveryPoint
Guam GUM GU DeliveryPoint Premise
Guatemala GTM GT Premise Thoroughfare
Guernsey GGY GG Locality Locality
Guinea GIN GN Locality Locality
Guinea-Bissau GNB GW Locality Locality
Guyana GUY GY Premise Thoroughfare
Haiti HTI HT Locality Locality
Holy See VAT VA AdministrativeArea Locality
Honduras HND HN Thoroughfare Thoroughfare
Hong Kong HKG HK DeliveryPoint DeliveryPoint
Hungary HUN HU DeliveryPoint DeliveryPoint
Iceland ISL IS Premise DeliveryPoint
India IND IN Premise Thoroughfare
Indonesia IDN ID DeliveryPoint DeliveryPoint
Iraq IRQ IQ Premise Thoroughfare
Ireland IRL IE DeliveryPoint DeliveryPoint
Islamic Republic of Iran IRN IR Locality Locality
Isle of Man IMN IM Locality Locality
Israel ISR IL DeliveryPoint DeliveryPoint
Italy ITA IT DeliveryPoint DeliveryPoint
Ivory Coast CIV CI Locality Locality
Jamaica JAM JM Premise Thoroughfare
Japan JPN JP DeliveryPoint DeliveryPoint
Jersey JEY JE Locality Locality
Jordan JOR JO DeliveryPoint DeliveryPoint
Kazakhstan KAZ KZ Premise Premise
Kenya KEN KE Premise Thoroughfare
Kiribati KIR KI Locality Locality
Kuwait KWT KW Premise Premise
Kyrgyzstan KGZ KG Locality Locality
Lao People's Democratic Republic LAO LA Locality Locality
Latvia LVA LV DeliveryPoint DeliveryPoint
Lebanon LBN LB Premise Thoroughfare
Lesotho LSO LS Locality Locality
Liberia LBR LR Locality Locality
Libya LBY LY Locality Locality
Liechtenstein LIE LI DeliveryPoint DeliveryPoint
Lithuania LTU LT DeliveryPoint DeliveryPoint
Luxembourg LUX LU DeliveryPoint DeliveryPoint
Macao MAC MO DeliveryPoint DeliveryPoint
Madagascar MDG MG Locality Locality
Malawi MWI MW Locality Locality
Malaysia MYS MY DeliveryPoint DeliveryPoint
Maldives MDV MV Locality Locality
Mali MLI ML Locality Locality
Malta MLT MT Premise Thoroughfare
Marshall Islands MHL MH Premise Premise
Martinique MTQ MQ DeliveryPoint DeliveryPoint
Mauritania MRT MR Locality Locality
Mauritius MUS MU Premise Thoroughfare
Mayotte MYT YT Thoroughfare Thoroughfare
Mexico MEX MX DeliveryPoint DeliveryPoint
Monaco MCO MC Premise Premise
Mongolia MNG MN Locality Locality
Montenegro MNE ME DeliveryPoint DeliveryPoint
Montserrat MSR MS AdministrativeArea Locality
Morocco MAR MA Premise Premise
Mozambique MOZ MZ Premise Thoroughfare
Myanmar MMR MM Locality Locality
Namibia NAM NA Premise Premise
Nauru NRU NR AdministrativeArea Locality
Nepal NPL NP Locality Locality
Netherlands NLD NL DeliveryPoint DeliveryPoint
New Caledonia NCL NC Locality Locality
New Zealand NZL NZ DeliveryPoint DeliveryPoint
Nicaragua NIC NI Premise Thoroughfare
Niger NER NE Premise Thoroughfare
Nigeria NGA NG Premise Thoroughfare
Niue NIU NU AdministrativeArea Locality
Norfolk Island NFK NF AdministrativeArea Locality
Northern Mariana Islands MNP MP DeliveryPoint Premise
Norway NOR NO DeliveryPoint DeliveryPoint
Oman OMN OM Premise Thoroughfare
Pakistan PAK PK Locality Locality
Palau PLW PW Premise Premise
Panama PAN PA Premise Premise
Papua New Guinea PNG PG Locality Locality
Paraguay PRY PY Premise Premise
Peru PER PE DeliveryPoint DeliveryPoint
Philippines PHL PH DeliveryPoint DeliveryPoint
Pitcairn PCN PN AdministrativeArea Locality
Poland POL PL DeliveryPoint DeliveryPoint
Portugal PRT PT DeliveryPoint DeliveryPoint
Puerto Rico PRI PR DeliveryPoint Premise
Qatar QAT QA DeliveryPoint DeliveryPoint
Republic of Korea KOR KR DeliveryPoint DeliveryPoint
Republic of Moldova MDA MD DeliveryPoint DeliveryPoint
Republic of North Macedonia MKD MK Premise Premise
Réunion REU RE DeliveryPoint DeliveryPoint
Romania ROU RO DeliveryPoint DeliveryPoint
Russian Federation RUS RU DeliveryPoint DeliveryPoint
Rwanda RWA RW Locality Locality
Saint Barthélemy BLM BL Premise Premise
Saint Helena, Ascension and Tristan da Cunha SHN SH AdministrativeArea Locality
Saint Kitts and Nevis KNA KN Locality Locality
Saint Lucia LCA LC Locality Locality
Saint Martin MAF MF AdministrativeArea Locality
Saint Pierre and Miquelon SPM PM AdministrativeArea Locality
Saint Vincent and the Grenadines VCT VC Locality Locality
Samoa WSM WS AdministrativeArea Locality
San Marino SMR SM DeliveryPoint DeliveryPoint
Sao Tome and Principe STP ST AdministrativeArea Locality
Saudi Arabia SAU SA DeliveryPoint DeliveryPoint
Senegal SEN SN Thoroughfare Thoroughfare
Serbia SRB RS DeliveryPoint DeliveryPoint
Seychelles SYC SC Locality Locality
Sierra Leone SLE SL Locality Locality
Singapore SGP SG DeliveryPoint DeliveryPoint
Sint Maarten (Dutch) SXM SX Locality Locality
Slovakia SVK SK DeliveryPoint DeliveryPoint
Slovenia SVN SI DeliveryPoint DeliveryPoint
Solomon Islands SLB SB AdministrativeArea Locality
Somalia SOM SO Locality Locality
South Africa ZAF ZA DeliveryPoint DeliveryPoint
South Georgia and the South Sandwich Islands SGS GS AdministrativeArea Locality
South Sudan SSD SS AdministrativeArea Locality
Spain ESP ES DeliveryPoint DeliveryPoint
Sri Lanka LKA LK Premise Thoroughfare
State of Palestine PSE PS Locality Locality
Sudan SDN SD Locality Locality
Suriname SUR SR Locality Locality
Svalbard and Jan Mayen Islands SJM SJ AdministrativeArea Locality
Sweden SWE SE DeliveryPoint DeliveryPoint
Switzerland CHE CH DeliveryPoint DeliveryPoint
Syrian Arab Republic SYR SY Locality Locality
Taiwan TWN TW DeliveryPoint DeliveryPoint
Tajikistan TJK TJ DeliveryPoint DeliveryPoint
Thailand THA TH DeliveryPoint DeliveryPoint
Timor-Leste TLS TL AdministrativeArea Locality
Togo TGO TG Locality Locality
Tokelau TKL TK AdministrativeArea Locality
Tonga TON TO AdministrativeArea Locality
Trinidad and Tobago TTO TT Premise Thoroughfare
Tunisia TUN TN Premise Premise
Turkey TUR TR DeliveryPoint DeliveryPoint
Turkmenistan TKM TM AdministrativeArea Locality
Turks and Caicos Islands TCA TC Locality Locality
Tuvalu TUV TV AdministrativeArea Locality
Uganda UGA UG Premise Thoroughfare
Ukraine UKR UA DeliveryPoint DeliveryPoint
United Arab Emirates ARE AE DeliveryPoint DeliveryPoint
United Kingdom GBR GB DeliveryPoint DeliveryPoint
United Republic of Tanzania TZA TZ Premise Thoroughfare
United States Minor Outlying Islands UMI UM AdministrativeArea Locality
United States of America USA US DeliveryPoint DeliveryPoint
Uruguay URY UY DeliveryPoint DeliveryPoint
Uzbekistan UZB UZ Locality Locality
Vanuatu VUT VU AdministrativeArea Locality
Viet Nam VNM VN DeliveryPoint DeliveryPoint
Virgin Islands (U.S.) VIR VI DeliveryPoint Premise
Wallis and Futuna WLF WF AdministrativeArea Locality
Western Sahara ESH EH AdministrativeArea Locality
Yemen YEM YE Premise Thoroughfare
Zambia ZMB ZM Premise Thoroughfare
Zimbabwe ZWE ZW Premise Thoroughfare

SSL/TLS Information

Use modern security software and cipher suites.

The leader in location data intelligence

Ready to get started?