{"id":522,"date":"2022-10-08T15:26:01","date_gmt":"2022-10-08T15:26:01","guid":{"rendered":"https:\/\/serviceobjects.wpaladdin.com\/?post_type=serviceobjects&#038;p=522"},"modified":"2023-05-11T11:50:33","modified_gmt":"2023-05-11T18:50:33","slug":"av3-errors","status":"publish","type":"page","link":"https:\/\/test.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-errors\/","title":{"rendered":"AV3 &#8211; Errors"},"content":{"rendered":"\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/test.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-errors\/#AV3-Errors-ErrorTypes\">Error Types<\/a>\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/test.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-errors\/#AV3-Errors-Errortype1:Authorization\">Error type 1: Authorization<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/test.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-errors\/#AV3-Errors-Errortype2:UserInput\">Error type 2: User Input<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/test.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-errors\/#AV3-Errors-Errortype3:ServiceObjectsFatal\">Error type 3: Service Objects Fatal<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/test.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-errors\/#AV3-Errors-Errortype4:DomainSpecific\">Error type 4: Domain Specific<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<p>Anything that happens during a run of DOTS Address Validation 3 that causes it to be unable to finish its normal processing is an error. If an error occurs, something similar to the following will result instead of the normal\/typical output:&nbsp;<\/p>\n\n\n\n<p><strong>Example:<\/strong><\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"xml\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">*Error!*\n  &lt;Type>Authorization&lt;\/Type>\n  &lt;TypeCode>1&lt;\/TypeCode>\n  &lt;Desc>Your license key does not work on this service.&lt;\/Desc>\n  &lt;DescCode>8&lt;\/DescCode><\/pre>\n\n\n\n<p><br>There are four error types described below.<\/p>\n\n\n\n<h1 class=\"wp-block-heading\" id=\"AV3-Errors-ErrorTypes\">Error Types<\/h1>\n\n\n\n<figure class=\"wp-block-table is-style-table-section\"><table><thead><tr><th>Type<\/th><th>TypeCode<\/th><th>Billable<\/th><th>Standard Across All Gen2 Web Services<\/th><\/tr><\/thead><tbody><tr><td>Authorization<\/td><td>1<\/td><td>No<\/td><td>Yes<\/td><\/tr><tr><td>User Input<\/td><td>2<\/td><td>No<\/td><td>No<\/td><\/tr><tr><td>Service Objects Fatal<\/td><td>3<\/td><td>No<\/td><td>Yes<\/td><\/tr><tr><td>Domain Specific<\/td><td>4<\/td><td>Yes<\/td><td>No<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"AV3-Errors-Errortype1:Authorization\">Error type 1: Authorization<\/h2>\n\n\n\n<p>Theses are standard to all Generation 2 DOTS Web Services.<\/p>\n\n\n\n<figure class=\"wp-block-table is-style-table-section\"><table><thead><tr><th>DescCode<\/th><th>Desc<\/th><\/tr><\/thead><tbody><tr><td>0<\/td><td>Unknown authorization error.<\/td><\/tr><tr><td>1<\/td><td>Please provide a valid license key for this web service.<\/td><\/tr><tr><td>2<\/td><td>The daily allowable number of transactions for this license key has been exceeded.<\/td><\/tr><tr><td>3<\/td><td>The monthly allowable number of transactions for this license key has been exceeded.<\/td><\/tr><tr><td>4<\/td><td>The total allowable number of transactions for this license key has been exceeded.<\/td><\/tr><tr><td>5<\/td><td>There are not enough transactions available. Check your daily\/monthly transaction limits.<\/td><\/tr><tr><td>6<\/td><td>This license key has not yet been activated.<\/td><\/tr><tr><td>7<\/td><td>This license key has expired.<\/td><\/tr><tr><td>8<\/td><td>Your license key does not work on this service<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"AV3-Errors-Errortype2:UserInput\">Error type 2: User Input<\/h2>\n\n\n\n<p>User Input errors are caused when a user inputs an invalid value or fails to provide a certain input field altogether. If a developer creates a request and mistypes a parameter name, it will probably cause a User Input Error.<\/p>\n\n\n\n<figure class=\"wp-block-table is-style-table-section\"><table><thead><tr><th>DescCode<\/th><th>Desc<\/th><\/tr><\/thead><tbody><tr><td>1*<\/td><td><s>Address and Address2 fields were too long.&nbsp; Together, they must be 100 characters or less.<\/s><\/td><\/tr><tr><td>2*<\/td><td><s>Address field was too long, must be 100 characters or less.<\/s><\/td><\/tr><tr><td>3<\/td><td>Please input a street address.<\/td><\/tr><tr><td>4<\/td><td>Please input either zip code or both city and state.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>*Deprecated DescCode that are no longer used.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"AV3-Errors-Errortype3:ServiceObjectsFatal\">Error type 3: Service Objects Fatal<\/h2>\n\n\n\n<p>The Desc will always be the same and the DescCode has no meaning. This is standard to all Generation 2 DOTS Web Services. This is a rare error that signals either a bug in the DOTS Address Validation 2 service, or a Network\/Connectivity issue.<\/p>\n\n\n\n<figure class=\"wp-block-table is-style-table-section\"><table><thead><tr><th>DescCode<\/th><th>Desc<\/th><\/tr><\/thead><tbody><tr><td>1<\/td><td>Unhandled error. Please contact Service Objects.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"AV3-Errors-Errortype4:DomainSpecific\">Error type 4: Domain Specific<\/h2>\n\n\n\n<p>Domain specific errors represent the common errors seen in Service Objects services. Domain Specific errors indicate that the service completed successfully but the result is not good.<\/p>\n\n\n\n<figure class=\"wp-block-table is-style-table-section\"><table><thead><tr><th>DescCode<\/th><th>Desc<\/th><th>Description<\/th><th>In use<\/th><\/tr><\/thead><tbody><tr><td>1<\/td><td>Address not found<\/td><td>Major issue with address that doesn&#8217;t fit known USPS special case scenarios.<\/td><td>Yes<\/td><\/tr><tr><td>3<\/td><td>Multiple addresses match<\/td><td>Several address candidates were found that are equally likely given the input.&nbsp;<br>Ex: &#8220;1 Main St&#8221; matches &#8220;1 E Main St&#8221; and &#8220;1 W Main St&#8221;.<\/td><td>Yes<\/td><\/tr><tr><td>5<\/td><td>Please enter a valid address number.<\/td><td><\/td><td>Yes<\/td><\/tr><tr><td>7<\/td><td>Street not found<\/td><td>Street name not found for general area (city\/state or zip)<\/td><td>Yes<\/td><\/tr><tr><td>8<\/td><td>Street number or box number out of range<\/td><td>Street name found in area, but the given primary number is not valid for that street<\/td><td>Yes<\/td><\/tr><tr><td>12<\/td><td>Internal error.<\/td><td>Returned when an unexpected error occurs while processing address, or for special address cases.<\/td><td>Yes<\/td><\/tr><tr><td>14<\/td><td>City not found<\/td><td>City name not found for given state or postal code<\/td><td>Yes<\/td><\/tr><tr><td>15<\/td><td>State not found<\/td><td>State abbreviation not found<\/td><td>Yes<\/td><\/tr><tr><td>16<\/td><td>DPV Lockout. Contact Service Objects immediately.<\/td><td>Returned for a specific type of address case known as a false positive.<\/td><td>Yes<\/td><\/tr><tr><td>17<\/td><td>Address not found but the region has General Delivery service<\/td><td>Given address not found, but the region provided matches a known area that only provides General Delivery services. Mail sent to &#8220;General Delivery&#8221; with the recipients name may get delivered to recipient. ***Update Coming Soon***<\/td><td>No<\/td><\/tr><tr><td>21<\/td><td>Unable to parse address.<\/td><td>Indicates that the input could not be parsed into address fragments.<\/td><td>Yes<\/td><\/tr><\/tbody><\/table><\/figure>\n","protected":false},"excerpt":{"rendered":"<p>Anything that happens during a run of DOTS Address Validation 3 that causes it to be unable to finish its normal processing is an error. If an error occurs, something similar to the following will result instead of the normal\/typical output:&nbsp; Example: There are four error types described below. Error Types Type TypeCode Billable Standard [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":491,"menu_order":2,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-522","page","type-page","status-publish","hentry"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v24.7 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>AV3 - Errors<\/title>\n<meta name=\"description\" content=\"Error Types Error type 1: Authorization Error type 2: User Input Error type 3: Service Objects Fatal Error type 4: Domain Specific Anything that happens\" \/>\n<meta name=\"robots\" content=\"noindex, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"AV3 - Errors\" \/>\n<meta property=\"og:description\" content=\"Error Types Error type 1: Authorization Error type 2: User Input Error type 3: Service Objects Fatal Error type 4: Domain Specific Anything that happens\" \/>\n<meta property=\"og:url\" content=\"https:\/\/test.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-errors\/\" \/>\n<meta property=\"og:site_name\" content=\"Service Objects | Contact, Phone, Email Verification | Data Quality Services\" \/>\n<meta property=\"article:modified_time\" content=\"2023-05-11T18:50:33+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=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-errors\/\",\"url\":\"https:\/\/test.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-errors\/\",\"name\":\"AV3 - Errors\",\"isPartOf\":{\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/#website\"},\"datePublished\":\"2022-10-08T15:26:01+00:00\",\"dateModified\":\"2023-05-11T18:50:33+00:00\",\"description\":\"Error Types Error type 1: Authorization Error type 2: User Input Error type 3: Service Objects Fatal Error type 4: Domain Specific Anything that happens\",\"breadcrumb\":{\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-errors\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/test.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-errors\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-errors\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/test.serviceobjects.com\/docs\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"DOTS Address Validation &#8211; US 3\",\"item\":\"https:\/\/test.serviceobjects.com\/docs\/dots-address-validation-us-3\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"AV3 &#8211; Errors\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/#website\",\"url\":\"https:\/\/test.serviceobjects.com\/docs\/\",\"name\":\"Service Objects | Contact, Phone, Email Verification | Data Quality Services\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/test.serviceobjects.com\/docs\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/#organization\",\"name\":\"Service Objects | Contact, Phone, Email Verification | Data Quality Services\",\"url\":\"https:\/\/test.serviceobjects.com\/docs\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/test.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/08\/SO-logo-2560px-transparent.png\",\"contentUrl\":\"https:\/\/test.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:\/\/test.serviceobjects.com\/docs\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"AV3 - Errors","description":"Error Types Error type 1: Authorization Error type 2: User Input Error type 3: Service Objects Fatal Error type 4: Domain Specific Anything that happens","robots":{"index":"noindex","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"og_locale":"en_US","og_type":"article","og_title":"AV3 - Errors","og_description":"Error Types Error type 1: Authorization Error type 2: User Input Error type 3: Service Objects Fatal Error type 4: Domain Specific Anything that happens","og_url":"https:\/\/test.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-errors\/","og_site_name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","article_modified_time":"2023-05-11T18:50:33+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/test.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-errors\/","url":"https:\/\/test.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-errors\/","name":"AV3 - Errors","isPartOf":{"@id":"https:\/\/test.serviceobjects.com\/docs\/#website"},"datePublished":"2022-10-08T15:26:01+00:00","dateModified":"2023-05-11T18:50:33+00:00","description":"Error Types Error type 1: Authorization Error type 2: User Input Error type 3: Service Objects Fatal Error type 4: Domain Specific Anything that happens","breadcrumb":{"@id":"https:\/\/test.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-errors\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/test.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-errors\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/test.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-errors\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/test.serviceobjects.com\/docs\/"},{"@type":"ListItem","position":2,"name":"DOTS Address Validation &#8211; US 3","item":"https:\/\/test.serviceobjects.com\/docs\/dots-address-validation-us-3\/"},{"@type":"ListItem","position":3,"name":"AV3 &#8211; Errors"}]},{"@type":"WebSite","@id":"https:\/\/test.serviceobjects.com\/docs\/#website","url":"https:\/\/test.serviceobjects.com\/docs\/","name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","description":"","publisher":{"@id":"https:\/\/test.serviceobjects.com\/docs\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/test.serviceobjects.com\/docs\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/test.serviceobjects.com\/docs\/#organization","name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","url":"https:\/\/test.serviceobjects.com\/docs\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/test.serviceobjects.com\/docs\/#\/schema\/logo\/image\/","url":"https:\/\/test.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/08\/SO-logo-2560px-transparent.png","contentUrl":"https:\/\/test.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:\/\/test.serviceobjects.com\/docs\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/522","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/comments?post=522"}],"version-history":[{"count":11,"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/522\/revisions"}],"predecessor-version":[{"id":9539,"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/522\/revisions\/9539"}],"up":[{"embeddable":true,"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/491"}],"wp:attachment":[{"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/media?parent=522"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}