Verify International Addresses

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:

• GET (for sending a single address)
• OPTIONS (for "pre-flight" cross domain requests)

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_precision ≠ DeliveryPoint 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.