{"id":2732,"date":"2022-11-09T14:30:17","date_gmt":"2022-11-09T14:30:17","guid":{"rendered":"https:\/\/serviceobjects.wpaladdin.com\/?post_type=serviceobjects&#038;p=2732"},"modified":"2025-08-21T15:34:39","modified_gmt":"2025-08-21T22:34:39","slug":"adi-findbestcountry","status":"publish","type":"page","link":"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective-international\/adi-operations\/adi-findbestcountry\/","title":{"rendered":"ADI &#8211; FindBestCountry"},"content":{"rendered":"<nav aria-label=\"FindBestCountry Navigation\">\n<ul class=\"is-style-bullets-list\">\n<li><a href=\"#ADI-FindBestCountry-URLEndpoints\">URL Endpoints<\/a><\/li>\n<li><a href=\"#ADI-FindBestCountry-FindBestCountryInputs\">FindBestCountry Inputs<\/a><\/li>\n<li><a href=\"#ADI-FindBestCountry-FindAddressOutputs\">FindAddress Outputs<\/a><\/li>\n<li><a href=\"#ADI-FindBestCountry-References\">References<\/a><\/li>\n<\/ul>\n<\/nav>\n<section aria-labelledby=\"ADI-FindBestCountry-URLEndpoints\">\n<h1 id=\"ADI-FindBestCountry-URLEndpoints\" class=\"wp-block-heading\">URL Endpoints<\/h1>\n<p>&nbsp;<\/p>\n<article aria-label=\"Available URL endpoints in JSON and XML\">\n<ul class=\"is-style-no-bullets-indented-list\">\n<li><strong>JSON<\/strong>\n<ul>\n<li><a href=\"https:\/\/trial.serviceobjects.com\/ADI\/api.svc\/json\/FindBestCountry?CompanyName={COMPANYNAME}&amp;FullName={FULLNAME}&amp;FirstName={FIRSTNAME}&amp;LastName={LASTNAME}&amp;Address1={ADDRESS1}&amp;Address2={ADDRESS2}&amp;Address3={ADDRESS3}&amp;Address4={ADDRESS4}&amp;Address5={ADDRESS5}&amp;Address6={ADDRESS6}&amp;Address7={ADDRESS7}&amp;Address8={ADDRESS8}&amp;Locality={LOCALITY}&amp;AdminArea={ADMINAREA}&amp;PostalCode={POSTALCODE}&amp;Phone1={PHONE1}&amp;Phone2={PHONE2}&amp;Phone3={PHONE3}&amp;Email={EMAIL}&amp;IPAddress={IPADDRESS}&amp;Domain={DOMAIN}&amp;LicenseKey={LICENSEKEY}\">https:\/\/trial.serviceobjects.com\/ADI\/api.svc\/json\/FindBestCountry?CompanyName={COMPANYNAME}&amp;FullName={FULLNAME}&amp;FirstName={FIRSTNAME}&amp;LastName={LASTNAME}&amp;Address1={ADDRESS1}&amp;Address2={ADDRESS2}&amp;Address3={ADDRESS3}&amp;Address4={ADDRESS4}&amp;Address5={ADDRESS5}&amp;Address6={ADDRESS6}&amp;Address7={ADDRESS7}&amp;Address8={ADDRESS8}&amp;Locality={LOCALITY}&amp;AdminArea={ADMINAREA}&amp;PostalCode={POSTALCODE}&amp;Phone1={PHONE1}&amp;Phone2={PHONE2}&amp;Phone3={PHONE3}&amp;Email={EMAIL}&amp;IPAddress={IPADDRESS}&amp;Domain={DOMAIN}&amp;LicenseKey={LICENSEKEY}<\/a><\/li>\n<\/ul>\n<\/li>\n<li><strong>XML<\/strong>\n<ul>\n<li><a href=\"https:\/\/trial.serviceobjects.com\/ADI\/api.svc\/xml\/FindBestCountry?CompanyName={COMPANYNAME}&amp;FullName={FULLNAME}&amp;FirstName={FIRSTNAME}&amp;LastName={LASTNAME}&amp;Address1={ADDRESS1}&amp;Address2={ADDRESS2}&amp;Address3={ADDRESS3}&amp;Address4={ADDRESS4}&amp;Address5={ADDRESS5}&amp;Address6={ADDRESS6}&amp;Address7={ADDRESS7}&amp;Address8={ADDRESS8}&amp;Locality={LOCALITY}&amp;AdminArea={ADMINAREA}&amp;PostalCode={POSTALCODE}&amp;Phone1={PHONE1}&amp;Phone2={PHONE2}&amp;Phone3={PHONE3}&amp;Email={EMAIL}&amp;IPAddress={IPADDRESS}&amp;Domain={DOMAIN}&amp;LicenseKey={LICENSEKEY}\">https:\/\/trial.serviceobjects.com\/ADI\/api.svc\/xml\/FindBestCountry?CompanyName={COMPANYNAME}&amp;FullName={FULLNAME}&amp;FirstName={FIRSTNAME}&amp;LastName={LASTNAME}&amp;Address1={ADDRESS1}&amp;Address2={ADDRESS2}&amp;Address3={ADDRESS3}&amp;Address4={ADDRESS4}&amp;Address5={ADDRESS5}&amp;Address6={ADDRESS6}&amp;Address7={ADDRESS7}&amp;Address8={ADDRESS8}&amp;Locality={LOCALITY}&amp;AdminArea={ADMINAREA}&amp;PostalCode={POSTALCODE}&amp;Phone1={PHONE1}&amp;Phone2={PHONE2}&amp;Phone3={PHONE3}&amp;Email={EMAIL}&amp;IPAddress={IPADDRESS}&amp;Domain={DOMAIN}&amp;LicenseKey={LICENSEKEY}<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/article>\n<\/section>\n<section aria-labelledby=\"ADI-FindBestCountry-FindBestCountryInputs\">\n<h1 id=\"ADI-FindBestCountry-FindBestCountryInputs\" class=\"wp-block-heading\">FindBestCountry Inputs<\/h1>\n<p>&nbsp;<\/p>\n<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th>Name<\/th>\n<th>Type<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>CompanyName<\/td>\n<td>String<\/td>\n<td>The contacts company name. e.g. Service Objects *** This value is not currently used by the service.<\/td>\n<\/tr>\n<tr>\n<td>FullName<\/td>\n<td>String<\/td>\n<td>The contact&#8217;s full name. e.g. Jane Doe *** This value is not currently used by the service.<\/td>\n<\/tr>\n<tr>\n<td>FirstName<\/td>\n<td>String<\/td>\n<td>First name of the contact. e.g. Jane\u00a0*** This value is not currently used by the service.<\/td>\n<\/tr>\n<tr>\n<td>LastName<\/td>\n<td>String<\/td>\n<td>Last name of the contact. e.g. Doe\u00a0*** This value is not currently used by the service.<\/td>\n<\/tr>\n<tr>\n<td>Address1<\/td>\n<td>String<\/td>\n<td>The address line 1 of the contact or business address.<\/td>\n<\/tr>\n<tr>\n<td>Address2<\/td>\n<td>String<\/td>\n<td>The address line 2 of the contact or business address.<\/td>\n<\/tr>\n<tr>\n<td>Address3<\/td>\n<td>String<\/td>\n<td>The address line 3 of the contact or business address.<\/td>\n<\/tr>\n<tr>\n<td>Address4<\/td>\n<td>String<\/td>\n<td>The address line 4 of the contact or business address.<\/td>\n<\/tr>\n<tr>\n<td>Address5<\/td>\n<td>String<\/td>\n<td>The address line 5 of the contact or business address.<\/td>\n<\/tr>\n<tr>\n<td>Address6<\/td>\n<td>String<\/td>\n<td>The address line 6 of the contact or business address.<\/td>\n<\/tr>\n<tr>\n<td>Address7<\/td>\n<td>String<\/td>\n<td>The address line 7 of the contact or business address.<\/td>\n<\/tr>\n<tr>\n<td>Address8<\/td>\n<td>String<\/td>\n<td>The address line 8 of the contact or business address.<\/td>\n<\/tr>\n<tr>\n<td>Locality<\/td>\n<td>String<\/td>\n<td>The locality of the contact&#8217;s postal address, such as a city, town, village or other type of municipality.<\/td>\n<\/tr>\n<tr>\n<td>AdminArea<\/td>\n<td>String<\/td>\n<td>The name of the administrative division of the contact&#8217;s postal address. Commonly the primary division of a country, such as a State, Region, Province, County, Territory or Prefecture.<\/td>\n<\/tr>\n<tr>\n<td>PostalCode<\/td>\n<td>String<\/td>\n<td>The contact&#8217;s postal address postal code or its equivalent, such as a ZIP code (US), PLZ (DE, AU, and CH), PIN code (IN) and CAP (IT).<\/td>\n<\/tr>\n<tr>\n<td>Phone1<\/td>\n<td>String<\/td>\n<td>The contact&#8217;s primary phone number. e.g. office number<\/td>\n<\/tr>\n<tr>\n<td>Phone2<\/td>\n<td>String<\/td>\n<td>The contact&#8217;s secondary phone number. e.g. fax number<\/td>\n<\/tr>\n<tr>\n<td>Phone3<\/td>\n<td>String<\/td>\n<td>The contact&#8217;s tertiary phone number. e.g. direct number<\/td>\n<\/tr>\n<tr>\n<td>Email<\/td>\n<td>String<\/td>\n<td>The contact&#8217;s email address.<\/td>\n<\/tr>\n<tr>\n<td>IPAddress<\/td>\n<td>String<\/td>\n<td>The contact&#8217;s IP address in IPv4. (IPv6 coming in a future release).<\/td>\n<\/tr>\n<tr>\n<td>Domain<\/td>\n<td>String<\/td>\n<td>Website domain associated with the business. e.g.\u00a0<a href=\"https:\/\/www.serviceobjects.com\/\" target=\"_blank\" rel=\"noreferrer noopener\">serviceobjects.com<\/a>\u00a0*** This value is not currently used by the service.<\/td>\n<\/tr>\n<tr>\n<td>LicenseKey<\/td>\n<td>String<\/td>\n<td>Your license key to use the service.\u00a0This is a required value.<br \/>\nSign up for a free trial key at<br \/>\n<a href=\"https:\/\/www.serviceobjects.com\/\" target=\"_blank\" rel=\"noreferrer noopener\">www.serviceobjects.com<\/a>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<\/section>\n<section aria-labelledby=\"ADI-FindBestCountry-FindAddressOutputs\">\n<h1 id=\"ADI-FindBestCountry-FindAddressOutputs\" class=\"wp-block-heading\">FindAddress Outputs<\/h1>\n<p>&nbsp;<\/p>\n<figure class=\"wp-block-table is-style-table-section\">\n<article aria-label=\"CountryDetectionResponse Note\"><em>CountryDetectionResponse<\/em><\/article>\n<table>\n<thead>\n<tr>\n<th>Name<\/th>\n<th>Type<\/th>\n<th>Values<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>CountryDetection<\/td>\n<td>CountryDetection<\/td>\n<td>Varies<\/td>\n<td>The country detection object that returns query status and a Best Country if one was found.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"..\/..\/adi-errors\/\" target=\"_blank\" rel=\"noreferrer noopener\">Error<\/a><\/td>\n<td>Error<\/td>\n<td>Varies<\/td>\n<td>Error object indicating why the service could not return a result. See \u201cErrors\u201d below for more information.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<figure class=\"wp-block-table is-style-table-section\">\n<article aria-label=\"CountryDetection Note\"><em>CountryDetection<\/em><\/article>\n<table>\n<thead>\n<tr>\n<th>Name<\/th>\n<th>Type<\/th>\n<th>Values<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Status<\/td>\n<td>String<\/td>\n<td>OK<br \/>\nWARNING<\/td>\n<td>Indicates if the request was successfully able to find a best matching country for the contact or not.<\/td>\n<\/tr>\n<tr>\n<td>TotalScore<\/td>\n<td>String<\/td>\n<td>0-100<\/td>\n<td>Returns a score between 0 and 100.<br \/>\nThe score is based on the number of contact components submitted. Some components are worth more than others. For example, the address component will have a higher score than the email component. The more contact component input values that are given, the greater the likelihood for the service to return a high score.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"..\/..\/adi-note-codes-and-warning-codes\/\" target=\"_blank\" rel=\"noreferrer noopener\">Notes<\/a><\/td>\n<td>String or NULL<\/td>\n<td>See &#8220;Note Codes &amp; Descriptions&#8221; for possible values and details.<\/td>\n<td>Comma-separated list of descriptive note codes.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"..\/..\/adi-note-codes-and-warning-codes\/\" target=\"_blank\" rel=\"noreferrer noopener\">NotesDesc<\/a><\/td>\n<td>String or NULL<\/td>\n<td>See &#8220;Note Codes &amp; Descriptions&#8221; for possible values and details.<\/td>\n<td>Comma-separated list of descriptions that correspond to the Notes output.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"..\/..\/adi-note-codes-and-warning-codes\/\" target=\"_blank\" rel=\"noreferrer noopener\">Warnings<\/a><\/td>\n<td>String or NULL<\/td>\n<td>See &#8220;Warning Codes &amp; Descriptions&#8221; for possible values and details.<\/td>\n<td>Comma-separated\u00a0list of warning codes.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"..\/..\/adi-note-codes-and-warning-codes\/\" target=\"_blank\" rel=\"noreferrer noopener\">WarningsDesc<\/a><\/td>\n<td>String or NULL<\/td>\n<td>See &#8220;Warning Codes &amp; Descriptions&#8221; for possible values and details.<\/td>\n<td>Comma-separated list of descriptions that correspond to the Warnings output.<\/td>\n<\/tr>\n<tr>\n<td>Best_CountryName <a href=\"#ADI-FindBestCountry-References\"><sup>[1]<\/sup><\/a><\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>The name of the country that best matches the contact.<\/td>\n<\/tr>\n<tr>\n<td>Best_CountryLocalName<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>*The endonym or autonym of the best matching country for the contact. This is the internal name used by the locals of the country. e.g. Germany is\u00a0Deutschland<\/td>\n<\/tr>\n<tr>\n<td>Best_CountryISO2<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>The ISO 3166-1 Alpha-2 Country Code of the country that best macthes the contact as a whole.<\/td>\n<\/tr>\n<tr>\n<td>Best_CountryISO3<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>The ISO 3166-1 Alpha-3 Country Code of the country that best macthes the contact as a whole.<\/td>\n<\/tr>\n<tr>\n<td>Address_Score<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>Represents the score of the contact&#8217;s address component and how much it contributes to the total score.<\/td>\n<\/tr>\n<tr>\n<td>Address_CountryName<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>The name of the country that best matches the contact&#8217;s address component.<\/td>\n<\/tr>\n<tr>\n<td>Address_CountryLocalName<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>*The\u00a0endonym or autonym\u00a0of the country that best matches the contact&#8217;s address component.<\/td>\n<\/tr>\n<tr>\n<td>Address_CountryISO2<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>The\u00a0ISO 3166-1 Alpha-2 Country Code\u00a0of the country that best matches the contact&#8217;s address component.<\/td>\n<\/tr>\n<tr>\n<td>Address_CountryISO3<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>The\u00a0ISO 3166-1 Alpha-3 Country Code\u00a0of the country that best matches the contact&#8217;s address component.<\/td>\n<\/tr>\n<tr>\n<td>Address_AllCountriesFoundISO2<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>A comma-separated list of\u00a0ISO 3166-1 Alpha-2 Country Codes for all the countries that matched the contact&#8217;s address component.<\/td>\n<\/tr>\n<tr>\n<td>Phone1_Score<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>Represents the score of the contact&#8217;s phone1 component and how much it contributes to the total score.<\/td>\n<\/tr>\n<tr>\n<td>Phone1_CountryName<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>The name of the country that best matches the contact&#8217;s phone1 component.<\/td>\n<\/tr>\n<tr>\n<td>Phone1_CountryLocalName<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>*The endonym or autonym of the country that best matches the contact&#8217;s phone1 component.<\/td>\n<\/tr>\n<tr>\n<td>Phone1_CountryISO2<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>The ISO 3166-1 Alpha-2 Country Code of the country that best matches the contact&#8217;s phone1 component.<\/td>\n<\/tr>\n<tr>\n<td>Phone1_CountryISO3<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>The ISO 3166-1 Alpha-3 Country Code of the country that best matches the contact&#8217;s phone1 component.<\/td>\n<\/tr>\n<tr>\n<td>Phone1_AllCountriesFoundISO2<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>A comma-separated list of ISO 3166-1 Alpha-2 Country Codes for all the countries that matched the contact&#8217;s phone1 component.<\/td>\n<\/tr>\n<tr>\n<td>Phone2_Score<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>Represents the score of the contact&#8217;s phone2 component and how much it contributes to the total score.<\/td>\n<\/tr>\n<tr>\n<td>Phone2_CountryName<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>The name of the country that best matches the contact&#8217;s phone2 component.<\/td>\n<\/tr>\n<tr>\n<td>Phone2_CountryLocalName<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>*The endonym or autonym of the country that best matches the contact&#8217;s phone2 component.<\/td>\n<\/tr>\n<tr>\n<td>Phone2_CountryISO2<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>The ISO 3166-1 Alpha-2 Country Code of the country that best matches the contact&#8217;s phone2 component.<\/td>\n<\/tr>\n<tr>\n<td>Phone2_CountryISO3<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>The ISO 3166-1 Alpha-3 Country Code of the country that best matches the contact&#8217;s phone2 component.<\/td>\n<\/tr>\n<tr>\n<td>Phone2_AllCountriesFoundISO2<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>A comma-separated list of ISO 3166-1 Alpha-2 Country Codes for all the countries that matched the contact&#8217;s phone2 component.<\/td>\n<\/tr>\n<tr>\n<td>Phone3_Score<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>Represents the score of the contact&#8217;s phone3 component and how much it contributes to the total score.<\/td>\n<\/tr>\n<tr>\n<td>Phone3_CountryName<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>The name of the country that best matches the contact&#8217;s phone3 component.<\/td>\n<\/tr>\n<tr>\n<td>Phone3_CountryLocalName<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>*The endonym or autonym of the country that best matches the contact&#8217;s phone3 component.<\/td>\n<\/tr>\n<tr>\n<td>Phone3_CountryISO2<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>The ISO 3166-1 Alpha-2 Country Code of the country that best matches the contact&#8217;s phone3 component.<\/td>\n<\/tr>\n<tr>\n<td>Phone3_CountryISO3<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>The ISO 3166-1 Alpha-3 Country Code of the country that best matches the contact&#8217;s phone3 component.<\/td>\n<\/tr>\n<tr>\n<td>Phone3_AllCountriesFoundISO2<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>A comma-separated list of ISO 3166-1 Alpha-2 Country Codes for all the countries that matched the contact&#8217;s phone3 component.<\/td>\n<\/tr>\n<tr>\n<td>IPAddress_Score<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>Represents the score of the contact&#8217;s IP address component and how much it contributes to the total score.<\/td>\n<\/tr>\n<tr>\n<td>IPAddress_CountryName<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>The name of the country that best matches the contact&#8217;s IP address component.<\/td>\n<\/tr>\n<tr>\n<td>IPAddress_CountryLocalName<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>*The endonym or autonym of the country that best matches the contact&#8217;s IP address component.<\/td>\n<\/tr>\n<tr>\n<td>IPAddress_CountryISO2<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>The ISO 3166-1 Alpha-2 Country Code of the country that best matches the contact&#8217;s IP address component.<\/td>\n<\/tr>\n<tr>\n<td>IPAddress_CountryISO3<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>The ISO 3166-1 Alpha-3 Country Code of the country that best matches the contact&#8217;s IP address component.<\/td>\n<\/tr>\n<tr>\n<td>IPAddress_AllCountriesFoundISO2<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>A comma-separated list of ISO 3166-1 Alpha-2 Country Codes for all the countries that matched the contact&#8217;s IP address component.<\/td>\n<\/tr>\n<tr>\n<td>Email_Score<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>Represents the score of the contact&#8217;s email address component and how much it contributes to the total score.<\/td>\n<\/tr>\n<tr>\n<td>Email_CountryName<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>The name of the country that best matches the contact&#8217;s email address component.<\/td>\n<\/tr>\n<tr>\n<td>Email_CountryLocalName<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>*The endonym or autonym of the country that best matches the contact&#8217;s email address component.<\/td>\n<\/tr>\n<tr>\n<td>Email_CountryISO2<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>The ISO 3166-1 Alpha-2 Country Code of the country that best matches the contact&#8217;s email address component.<\/td>\n<\/tr>\n<tr>\n<td>Email_CountryISO3<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>A comma-separated list of ISO 3166-1 Alpha-2 Country Codes for all the countries that matched the contact&#8217;s email address component.<\/td>\n<\/tr>\n<tr>\n<td>Email_AllCountriesFoundISO2<\/td>\n<td>String or NULL<\/td>\n<td>Varies<\/td>\n<td>A comma-separated list of ISO 3166-1 Alpha-2 Country Codes for all the countries that matched the contact&#8217;s email address component.<\/td>\n<\/tr>\n<\/tbody>\n<\/table><figcaption class=\"wp-element-caption\">* Indicates that the output value is coming soon.<\/figcaption><\/figure>\n<\/section>\n<section aria-labelledby=\"ADI-FindBestCountry-References\">\n<h1 id=\"ADI-FindBestCountry-References\" class=\"wp-block-heading\">References<\/h1>\n<ol>\n<li><a href=\"#ADI-FindBestCountry-SingleCite_1_1\">^ <\/a><a href=\"https:\/\/www.serviceobjects.com\/blog\/where-in-the-world-dots-address-detective-international\/\" target=\"_blank\" rel=\"noreferrer noopener\">Where In The World &#8211; Address Detective International<\/a><\/li>\n<\/ol>\n<\/section>\n","protected":false},"excerpt":{"rendered":"<p>URL Endpoints FindBestCountry Inputs FindAddress Outputs References URL Endpoints &nbsp; JSON https:\/\/trial.serviceobjects.com\/ADI\/api.svc\/json\/FindBestCountry?CompanyName={COMPANYNAME}&amp;FullName={FULLNAME}&amp;FirstName={FIRSTNAME}&amp;LastName={LASTNAME}&amp;Address1={ADDRESS1}&amp;Address2={ADDRESS2}&amp;Address3={ADDRESS3}&amp;Address4={ADDRESS4}&amp;Address5={ADDRESS5}&amp;Address6={ADDRESS6}&amp;Address7={ADDRESS7}&amp;Address8={ADDRESS8}&amp;Locality={LOCALITY}&amp;AdminArea={ADMINAREA}&amp;PostalCode={POSTALCODE}&amp;Phone1={PHONE1}&amp;Phone2={PHONE2}&amp;Phone3={PHONE3}&amp;Email={EMAIL}&amp;IPAddress={IPADDRESS}&amp;Domain={DOMAIN}&amp;LicenseKey={LICENSEKEY} XML https:\/\/trial.serviceobjects.com\/ADI\/api.svc\/xml\/FindBestCountry?CompanyName={COMPANYNAME}&amp;FullName={FULLNAME}&amp;FirstName={FIRSTNAME}&amp;LastName={LASTNAME}&amp;Address1={ADDRESS1}&amp;Address2={ADDRESS2}&amp;Address3={ADDRESS3}&amp;Address4={ADDRESS4}&amp;Address5={ADDRESS5}&amp;Address6={ADDRESS6}&amp;Address7={ADDRESS7}&amp;Address8={ADDRESS8}&amp;Locality={LOCALITY}&amp;AdminArea={ADMINAREA}&amp;PostalCode={POSTALCODE}&amp;Phone1={PHONE1}&amp;Phone2={PHONE2}&amp;Phone3={PHONE3}&amp;Email={EMAIL}&amp;IPAddress={IPADDRESS}&amp;Domain={DOMAIN}&amp;LicenseKey={LICENSEKEY} FindBestCountry Inputs &nbsp; Name Type Description CompanyName String The contacts company name. e.g. Service Objects *** This value is not currently used by the service. FullName String The contact&#8217;s full name. e.g. Jane Doe *** This value is not currently used [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":2727,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-2732","page","type-page","status-publish","hentry"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v26.2 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>ADI - FindBestCountry<\/title>\n<meta name=\"description\" content=\"URL Endpoints FindBestCountry Inputs FindAddress Outputs References URL Endpoints &nbsp; JSON\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective-international\/adi-operations\/adi-findbestcountry\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"ADI - FindBestCountry\" \/>\n<meta property=\"og:description\" content=\"URL Endpoints FindBestCountry Inputs FindAddress Outputs References URL Endpoints &nbsp; JSON\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective-international\/adi-operations\/adi-findbestcountry\/\" \/>\n<meta property=\"og:site_name\" content=\"Service Objects | Contact, Phone, Email Verification | Data Quality Services\" \/>\n<meta property=\"article:modified_time\" content=\"2025-08-21T22:34:39+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"7 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective-international\/adi-operations\/adi-findbestcountry\/\",\"url\":\"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective-international\/adi-operations\/adi-findbestcountry\/\",\"name\":\"ADI - FindBestCountry\",\"isPartOf\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#website\"},\"datePublished\":\"2022-11-09T14:30:17+00:00\",\"dateModified\":\"2025-08-21T22:34:39+00:00\",\"description\":\"URL Endpoints FindBestCountry Inputs FindAddress Outputs References URL Endpoints &nbsp; JSON\",\"breadcrumb\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective-international\/adi-operations\/adi-findbestcountry\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective-international\/adi-operations\/adi-findbestcountry\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective-international\/adi-operations\/adi-findbestcountry\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.serviceobjects.com\/docs\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"DOTS Address Detective &#8211; International\",\"item\":\"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective-international\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"ADI &#8211; Operations\",\"item\":\"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective-international\/adi-operations\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"ADI &#8211; FindBestCountry\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#website\",\"url\":\"https:\/\/www.serviceobjects.com\/docs\/\",\"name\":\"Service Objects | Contact, Phone, Email Verification | Data Quality Services\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.serviceobjects.com\/docs\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#organization\",\"name\":\"Service Objects | Contact, Phone, Email Verification | Data Quality Services\",\"url\":\"https:\/\/www.serviceobjects.com\/docs\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/www.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/08\/SO-logo-2560px-transparent.png\",\"contentUrl\":\"https:\/\/www.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/08\/SO-logo-2560px-transparent.png\",\"width\":2560,\"height\":1440,\"caption\":\"Service Objects | Contact, Phone, Email Verification | Data Quality Services\"},\"image\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"ADI - FindBestCountry","description":"URL Endpoints FindBestCountry Inputs FindAddress Outputs References URL Endpoints &nbsp; JSON","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective-international\/adi-operations\/adi-findbestcountry\/","og_locale":"en_US","og_type":"article","og_title":"ADI - FindBestCountry","og_description":"URL Endpoints FindBestCountry Inputs FindAddress Outputs References URL Endpoints &nbsp; JSON","og_url":"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective-international\/adi-operations\/adi-findbestcountry\/","og_site_name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","article_modified_time":"2025-08-21T22:34:39+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"7 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective-international\/adi-operations\/adi-findbestcountry\/","url":"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective-international\/adi-operations\/adi-findbestcountry\/","name":"ADI - FindBestCountry","isPartOf":{"@id":"https:\/\/www.serviceobjects.com\/docs\/#website"},"datePublished":"2022-11-09T14:30:17+00:00","dateModified":"2025-08-21T22:34:39+00:00","description":"URL Endpoints FindBestCountry Inputs FindAddress Outputs References URL Endpoints &nbsp; JSON","breadcrumb":{"@id":"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective-international\/adi-operations\/adi-findbestcountry\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.serviceobjects.com\/docs\/dots-address-detective-international\/adi-operations\/adi-findbestcountry\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective-international\/adi-operations\/adi-findbestcountry\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.serviceobjects.com\/docs\/"},{"@type":"ListItem","position":2,"name":"DOTS Address Detective &#8211; International","item":"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective-international\/"},{"@type":"ListItem","position":3,"name":"ADI &#8211; Operations","item":"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective-international\/adi-operations\/"},{"@type":"ListItem","position":4,"name":"ADI &#8211; FindBestCountry"}]},{"@type":"WebSite","@id":"https:\/\/www.serviceobjects.com\/docs\/#website","url":"https:\/\/www.serviceobjects.com\/docs\/","name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","description":"","publisher":{"@id":"https:\/\/www.serviceobjects.com\/docs\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.serviceobjects.com\/docs\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.serviceobjects.com\/docs\/#organization","name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","url":"https:\/\/www.serviceobjects.com\/docs\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.serviceobjects.com\/docs\/#\/schema\/logo\/image\/","url":"https:\/\/www.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/08\/SO-logo-2560px-transparent.png","contentUrl":"https:\/\/www.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/08\/SO-logo-2560px-transparent.png","width":2560,"height":1440,"caption":"Service Objects | Contact, Phone, Email Verification | Data Quality Services"},"image":{"@id":"https:\/\/www.serviceobjects.com\/docs\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/2732","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/comments?post=2732"}],"version-history":[{"count":18,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/2732\/revisions"}],"predecessor-version":[{"id":11741,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/2732\/revisions\/11741"}],"up":[{"embeddable":true,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/2727"}],"wp:attachment":[{"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/media?parent=2732"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}