{"id":1609,"date":"2022-11-05T10:26:58","date_gmt":"2022-11-05T10:26:58","guid":{"rendered":"https:\/\/serviceobjects.wpaladdin.com\/?post_type=serviceobjects&#038;p=1609"},"modified":"2025-08-20T16:37:09","modified_gmt":"2025-08-20T23:37:09","slug":"ad-findoutlyingaddress","status":"publish","type":"page","link":"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective\/ad-operations\/ad-findoutlyingaddress\/","title":{"rendered":"AD &#8211; FindOutlyingAddress"},"content":{"rendered":"<nav aria-label=\"FindOutlyingAddress Navigation\">\n<ul class=\"is-style-bullets-list\">\n<li><a href=\"#AD-FindOutlyingAddress-URLEndpoints\">URL Endpoints<\/a><\/li>\n<li><a href=\"#AD-FindOutlyingAddress-FindOutlyingAddressInputs\">FindOutlyingAddress Inputs<\/a><\/li>\n<li><a href=\"#AD-FindOutlyingAddress-FindOutlyingAddressOutputs\">FindOutlyingAddress Outputs<\/a><\/li>\n<li><a href=\"#AD-FindOutlyingAddress-References\">References<\/a><\/li>\n<\/ul>\n<\/nav>\n<p>&nbsp;<\/p>\n<section aria-labelledby=\"AD-FindOutlyingAddress-URLEndpoints\">\n<article aria-label=\"Overview of FindOutlyingAddress Operation\">\n    Will leverage USPS data and additional data sources<br \/>\n  <\/article>\n<p>&nbsp;<\/p>\n<h2 id=\"AD-FindOutlyingAddress-URLEndpoints\">URL Endpoints<\/h2>\n<ul class=\"is-style-no-bullets-indented-list\">\n<li><strong>JSON:<\/strong>\n<ul>\n<li><a href=\"https:\/\/trial.serviceobjects.com\/ad\/api.svc\/FindOutlyingAddressJson?Address1={ADDRESS1}&amp;Address2={ADDRESS2}&amp;City={CITY}&amp;State={STATE}&amp;PostalCode={POSTALCODE}&amp;LicenseKey={LICENSEKEY}\">https:\/\/trial.serviceobjects.com\/ad\/api.svc\/FindOutlyingAddressJson?Address1={ADDRESS1}&amp;Address2={ADDRESS2}&amp;City={CITY}&amp;State={STATE}&amp;PostalCode={POSTALCODE}&amp;LicenseKey={LICENSEKEY}<\/a><\/li>\n<\/ul>\n<\/li>\n<li><strong>XML:<\/strong>\n<ul>\n<li><a href=\"https:\/\/trial.serviceobjects.com\/ad\/api.svc\/FindOutlyingAddress?Address1={ADDRESS1}&amp;Address2={ADDRESS2}&amp;City={CITY}&amp;State={STATE}&amp;PostalCode={POSTALCODE}&amp;LicenseKey={LICENSEKEY}\">https:\/\/trial.serviceobjects.com\/ad\/api.svc\/FindOutlyingAddress?Address1={ADDRESS1}&amp;Address2={ADDRESS2}&amp;City={CITY}&amp;State={STATE}&amp;PostalCode={POSTALCODE}&amp;LicenseKey={LICENSEKEY}<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/section>\n<section aria-labelledby=\"AD-FindOutlyingAddress-FindOutlyingAddressInputs\">\n<h2 id=\"AD-FindOutlyingAddress-FindOutlyingAddressInputs\">FindOutlyingAddress Inputs<\/h2>\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>Address<\/td>\n<td>String<\/td>\n<td>Address line of the address to validate.&nbsp;&nbsp;<br \/>For example, &#8220;123 Main Street&#8221;.<\/td>\n<\/tr>\n<tr>\n<td>Address2<\/td>\n<td>String<\/td>\n<td>This line is for address information that does not contribute to DPV coding an address. For example &#8220;C\/O John Smith&#8221; does not help validate the address, but is still useful in delivery.<\/td>\n<\/tr>\n<tr>\n<td>City<\/td>\n<td>String<\/td>\n<td>The city of the address to validate.&nbsp;<br \/>For example, &#8220;New York&#8221;.&nbsp; The city isn&#8217;t required, but if one is not provided, the Zip code is required.<\/td>\n<\/tr>\n<tr>\n<td>State<\/td>\n<td>String<\/td>\n<td>The state of the address to validate.&nbsp; For example, &#8220;NY&#8221;.&nbsp; This does not need to be contracted, full state names will work as well.&nbsp; The state isn&#8217;t required, but if one is not provided, the Zip code is required.<\/td>\n<\/tr>\n<tr>\n<td>PostalCode<\/td>\n<td>String<\/td>\n<td>The zip code of the address to validate.&nbsp; A zip code isn&#8217;t required, but if one is not provided, the City and State are required.<\/td>\n<\/tr>\n<tr>\n<td>LicenseKey*<\/td>\n<td>String<\/td>\n<td>Your license key to use the service.\u00a0\u00a0<br \/>Sign up for a free trial key at\u00a0<br \/><a rel=\"noreferrer noopener\" href=\"https:\/\/www.serviceobjects.com\/address-detective\/\" target=\"_blank\">https:\/\/www.serviceobjects.com\/address-detective\/<\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<\/section>\n<section aria-labelledby=\"AD-FindOutlyingAddress-FindOutlyingAddressOutputs\">\n<h2 id=\"AD-FindOutlyingAddress-FindOutlyingAddressOutputs\">FindOutlyingAddress Outputs<\/h2>\n<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th>Output Parameter<\/th>\n<th>Type<\/th>\n<th>Values<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Addresses<\/td>\n<td>OutlyingAddress[]<\/td>\n<td>Varies<\/td>\n<td><\/td>\n<\/tr>\n<tr>\n<td>InformationComponents<\/td>\n<td>InformationComponent[]<\/td>\n<td>Varies<\/td>\n<td>&nbsp;<\/td>\n<\/tr>\n<tr>\n<td>Level<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>The level to which the input address could be verified.<\/td>\n<\/tr>\n<tr>\n<td>Notes<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>Notes that can give information about the validity or <br \/>existence of an address<\/td>\n<\/tr>\n<tr>\n<td>NotesDesc<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>Descriptions of the Notes given in the notes field.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"\/docs\/dots-address-detective\/ad-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 <br \/>result. See \u201c<a rel=\"noreferrer noopener\" href=\"\/docs\/dots-address-detective\/ad-errors\/\" target=\"_blank\">Errors<\/a>\u201d page 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=\"OutlyingAddress Note\"><em>OutlyingAddress<\/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>Address1<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>The corrected Address line 1.<\/td>\n<\/tr>\n<tr>\n<td>Address2<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>The corrected Address line 2.<\/td>\n<\/tr>\n<tr>\n<td>City<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>The corrected city name.<\/td>\n<\/tr>\n<tr>\n<td>State<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>The corrected state name.<\/td>\n<\/tr>\n<tr>\n<td>Postal Code<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>The corrected zip code + 4.<\/td>\n<\/tr>\n<tr>\n<td>DPV <a href=\"#AD-FindOutlyingAddress-CiteSummary_1\"><sup>[1]<\/sup><\/a><\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>Number that correlates to a DPV(Delivery Point Validation) result. An indicator displaying whether or not the address is recognized as deliverable by the USPS.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<figure class=\"wp-block-table is-style-table-section\">\n<article aria-label=\"InformationComponent Note\"><em>InformationComponent<\/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>Name<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>The variable name of the Name-Value pair that is to be returned. Usually contains extraneous information like parsed address fields<\/td>\n<\/tr>\n<tr>\n<td>Value<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>The resulting value of the of the variable returned in the &#8220;Name&#8221; field.<\/td>\n<\/tr>\n<\/tbody>\n<\/table><figcaption class=\"wp-element-caption\">\n      <em><a href=\"\/docs\/dots-address-detective\/ad-codes-notes-corrections-scoring\/\">*See section on DPV Notes and Corrections for possible values\/descriptions<\/a><\/em><br \/>\n    <\/figcaption><\/figure>\n<\/section>\n<section aria-labelledby=\"AD-FindOutlyingAddress-References\">\n<h2 id=\"AD-FindOutlyingAddress-References\">References<\/h2>\n<ol id=\"AD-FindOutlyingAddress-CiteSummary_1\">\n<li>\n      <a href=\"https:\/\/www.serviceobjects.com\/blog\/cass-dpv-higher-standard-address-accuracy\/\" target=\"_blank\" rel=\"noreferrer noopener\">^CASS and DPV: A Higher Standard for Address Accuracy<\/a>\n    <\/li>\n<\/ol>\n<\/section>\n","protected":false},"excerpt":{"rendered":"<p>URL Endpoints FindOutlyingAddress Inputs FindOutlyingAddress Outputs References &nbsp; Will leverage USPS data and additional data sources &nbsp; URL Endpoints JSON: https:\/\/trial.serviceobjects.com\/ad\/api.svc\/FindOutlyingAddressJson?Address1={ADDRESS1}&amp;Address2={ADDRESS2}&amp;City={CITY}&amp;State={STATE}&amp;PostalCode={POSTALCODE}&amp;LicenseKey={LICENSEKEY} XML: https:\/\/trial.serviceobjects.com\/ad\/api.svc\/FindOutlyingAddress?Address1={ADDRESS1}&amp;Address2={ADDRESS2}&amp;City={CITY}&amp;State={STATE}&amp;PostalCode={POSTALCODE}&amp;LicenseKey={LICENSEKEY} FindOutlyingAddress Inputs Name Type Description Address String Address line of the address to validate.&nbsp;&nbsp;For example, &#8220;123 Main Street&#8221;. Address2 String This line is for address information that does not contribute to DPV [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":1522,"menu_order":2,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-1609","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>AD - FindOutlyingAddress<\/title>\n<meta name=\"description\" content=\"URL Endpoints FindOutlyingAddress Inputs FindOutlyingAddress Outputs References &nbsp; Will leverage USPS data and additional data sources &nbsp; URL\" \/>\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\/ad-operations\/ad-findoutlyingaddress\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"AD - FindOutlyingAddress\" \/>\n<meta property=\"og:description\" content=\"URL Endpoints FindOutlyingAddress Inputs FindOutlyingAddress Outputs References &nbsp; Will leverage USPS data and additional data sources &nbsp; URL\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective\/ad-operations\/ad-findoutlyingaddress\/\" \/>\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-20T23:37:09+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=\"2 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\/ad-operations\/ad-findoutlyingaddress\/\",\"url\":\"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective\/ad-operations\/ad-findoutlyingaddress\/\",\"name\":\"AD - FindOutlyingAddress\",\"isPartOf\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#website\"},\"datePublished\":\"2022-11-05T10:26:58+00:00\",\"dateModified\":\"2025-08-20T23:37:09+00:00\",\"description\":\"URL Endpoints FindOutlyingAddress Inputs FindOutlyingAddress Outputs References &nbsp; Will leverage USPS data and additional data sources &nbsp; URL\",\"breadcrumb\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective\/ad-operations\/ad-findoutlyingaddress\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective\/ad-operations\/ad-findoutlyingaddress\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective\/ad-operations\/ad-findoutlyingaddress\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.serviceobjects.com\/docs\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"DOTS Address Detective\",\"item\":\"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"AD &#8211; Operations\",\"item\":\"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective\/ad-operations\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"AD &#8211; FindOutlyingAddress\"}]},{\"@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":"AD - FindOutlyingAddress","description":"URL Endpoints FindOutlyingAddress Inputs FindOutlyingAddress Outputs References &nbsp; Will leverage USPS data and additional data sources &nbsp; URL","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\/ad-operations\/ad-findoutlyingaddress\/","og_locale":"en_US","og_type":"article","og_title":"AD - FindOutlyingAddress","og_description":"URL Endpoints FindOutlyingAddress Inputs FindOutlyingAddress Outputs References &nbsp; Will leverage USPS data and additional data sources &nbsp; URL","og_url":"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective\/ad-operations\/ad-findoutlyingaddress\/","og_site_name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","article_modified_time":"2025-08-20T23:37:09+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective\/ad-operations\/ad-findoutlyingaddress\/","url":"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective\/ad-operations\/ad-findoutlyingaddress\/","name":"AD - FindOutlyingAddress","isPartOf":{"@id":"https:\/\/www.serviceobjects.com\/docs\/#website"},"datePublished":"2022-11-05T10:26:58+00:00","dateModified":"2025-08-20T23:37:09+00:00","description":"URL Endpoints FindOutlyingAddress Inputs FindOutlyingAddress Outputs References &nbsp; Will leverage USPS data and additional data sources &nbsp; URL","breadcrumb":{"@id":"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective\/ad-operations\/ad-findoutlyingaddress\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.serviceobjects.com\/docs\/dots-address-detective\/ad-operations\/ad-findoutlyingaddress\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective\/ad-operations\/ad-findoutlyingaddress\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.serviceobjects.com\/docs\/"},{"@type":"ListItem","position":2,"name":"DOTS Address Detective","item":"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective\/"},{"@type":"ListItem","position":3,"name":"AD &#8211; Operations","item":"https:\/\/www.serviceobjects.com\/docs\/dots-address-detective\/ad-operations\/"},{"@type":"ListItem","position":4,"name":"AD &#8211; FindOutlyingAddress"}]},{"@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\/1609","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=1609"}],"version-history":[{"count":11,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/1609\/revisions"}],"predecessor-version":[{"id":11587,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/1609\/revisions\/11587"}],"up":[{"embeddable":true,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/1522"}],"wp:attachment":[{"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/media?parent=1609"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}