{"id":2254,"date":"2022-11-08T22:44:04","date_gmt":"2022-11-08T22:44:04","guid":{"rendered":"https:\/\/serviceobjects.wpaladdin.com\/?post_type=serviceobjects&#038;p=2254"},"modified":"2025-08-22T08:06:09","modified_gmt":"2025-08-22T15:06:09","slug":"avi-errors","status":"publish","type":"page","link":"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-international\/avi-errors\/","title":{"rendered":"AVI &#8211; Errors"},"content":{"rendered":"<nav class=\"is-style-bullets-list\" aria-label=\"AVI Errors Navigation\">\n<ul>\n<li><a href=\"#AVI-Errors-ErrorTypes\">Error Types<\/a>\n<ul>\n<li><a href=\"#AVI-Errors-Errortype1:Authorization\">Error type 1: Authorization<\/a><\/li>\n<li><a href=\"#AVI-Errors-Errortype2:UserInput\">Error type 2: User Input<\/a><\/li>\n<li><a href=\"#AVI-Errors-Errortype3:ServiceObjectsFatal\">Error type 3: Service Objects Fatal<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/nav>\n<article aria-label=\"General Explanation of AVI Errors\">&nbsp;<br \/>\nAnything that happens during a run of DOTS Address Validation International 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:\u00a0<br \/>\n&nbsp;<\/article>\n<article aria-label=\"Example Error Output\">\n<p><strong>Example:<\/strong><\/p>\n<figure class=\"wp-block-table is-style-regular\">\n<table>\n<tbody>\n<tr>\n<td>\u00a0<\/td>\n<td><strong>*Error!*<\/strong><br \/>\u00a0 &lt;Type&gt;Authorization&lt;\/Type&gt;<br \/>\u00a0 &lt;TypeCode&gt;1&lt;\/TypeCode&gt;<br \/>\u00a0 &lt;Desc&gt;Your license key does not work on this service.&lt;\/Desc&gt;<br \/>\u00a0 &lt;DescCode&gt;8&lt;\/DescCode&gt;<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<\/article>\n<article aria-label=\"Number of AVI Error Types\">\n<p>There are three error types described below.<\/p>\n<\/article>\n<section aria-labelledby=\"AVI-Errors-ErrorTypes\">\n<h2 id=\"AVI-Errors-ErrorTypes\">Error Types<\/h2>\n<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th scope=\"col\">Type<\/th>\n<th scope=\"col\">TypeCode<\/th>\n<th scope=\"col\">Billable<\/th>\n<th scope=\"col\">Standard Across All Gen2 Web Services<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Authorization<\/td>\n<td>1<\/td>\n<td>No<\/td>\n<td>Yes<\/td>\n<\/tr>\n<tr>\n<td>User Input<\/td>\n<td>2<\/td>\n<td>No<\/td>\n<td>No<\/td>\n<\/tr>\n<tr>\n<td>Service Objects Fatal<\/td>\n<td>3<\/td>\n<td>No<\/td>\n<td>Yes<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<\/section>\n<section aria-labelledby=\"AVI-Errors-Errortype1:Authorization\">\n<h2 id=\"AVI-Errors-Errortype1:Authorization\">Error type 1: Authorization<\/h2>\n<article aria-label=\"Description for Error Type 1: Authorization\">\n<ul class=\"is-style-no-bullets-indented-list\">\n<li>Theses are standard to all Generation 2 DOTS Web Services.<\/li>\n<\/ul>\n<\/article>\n<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th scope=\"col\">DescCode<\/th>\n<th scope=\"col\">Desc<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>0<\/td>\n<td>Unknown authorization error.<\/td>\n<\/tr>\n<tr>\n<td>1<\/td>\n<td>Please provide a valid license key for this web service.<\/td>\n<\/tr>\n<tr>\n<td>2<\/td>\n<td>The daily allowable number of transactions for this license key has been exceeded.<\/td>\n<\/tr>\n<tr>\n<td>3<\/td>\n<td>The monthly allowable number of transactions for this license key has been exceeded.<\/td>\n<\/tr>\n<tr>\n<td>4<\/td>\n<td>The total allowable number of transactions for this license key has been exceeded.<\/td>\n<\/tr>\n<tr>\n<td>5<\/td>\n<td>There are not enough transactions available. Check your daily\/monthly transaction limits.<\/td>\n<\/tr>\n<tr>\n<td>6<\/td>\n<td>This license key has not yet been activated.<\/td>\n<\/tr>\n<tr>\n<td>7<\/td>\n<td>This license key has expired.<\/td>\n<\/tr>\n<tr>\n<td>8<\/td>\n<td>Your license key does not work on this service<\/td>\n<\/tr>\n<tr>\n<td>13<\/td>\n<td>This country is limited to specific usage. Please contact customer service to have your key enabled.<\/td>\n<\/tr>\n<tr>\n<td>14<\/td>\n<td>This output language is limited to specific usage.\u00a0 Please contact customer service to have your key enabled.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<\/section>\n<section aria-labelledby=\"AVI-Errors-Errortype2:UserInput\">\n<h2 id=\"AVI-Errors-Errortype2:UserInput\">Error type 2: User Input<\/h2>\n<article aria-label=\"Description for Error Type 2: User Input\">\n<ul class=\"is-style-no-bullets-indented-list\">\n<li>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.<\/li>\n<\/ul>\n<\/article>\n<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th>DescCode<\/th>\n<th>Desc<\/th>\n<th>Additional Details<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>1<\/td>\n<td>You must input a license key in the LicenseKey field.<\/td>\n<td>\u00a0<\/td>\n<\/tr>\n<tr>\n<td>2<\/td>\n<td>The value of the OutputLanguage field is not supported.<\/td>\n<td>Occurs when an unsupported OutputLanguage value is submitted.<\/td>\n<\/tr>\n<tr>\n<td>3<\/td>\n<td>You must input an OutputLanguage.<\/td>\n<td>Occurs when the OutputLanguage field is missing or when the value is empty.<\/td>\n<\/tr>\n<tr>\n<td>4<\/td>\n<td>You must input a country name or country code in the Country field.<\/td>\n<td>\u00a0<\/td>\n<\/tr>\n<tr>\n<td>5<\/td>\n<td>The country entered is not supported.<\/td>\n<td>Indicates that the country entered may not necessarily be invalid but that the value is not supported. Either the value is not recognized or it is for a country that the service does not currently support.<\/td>\n<\/tr>\n<tr>\n<td>6<\/td>\n<td>The country entered is invalid<\/td>\n<td>\u00a0<\/td>\n<\/tr>\n<tr>\n<td>7<\/td>\n<td>You must input an address.<\/td>\n<td>Occurs when a value is not passed to the Address1-5 fields or when the value(s) does not appear to be an address.Examples: \u201cAttention John Smith\u201d or \u201cOn the corner of East and Main\u201d or \u201c9 ^&amp;*$@! Rd\u201d<\/td>\n<\/tr>\n<tr>\n<td>8<\/td>\n<td>The length of one or more address fields is too long.<\/td>\n<td>Occurs when the length of one or more of the Address1-5 field values exceeds 250 characters.<\/td>\n<\/tr>\n<tr>\n<td>9<\/td>\n<td>The length of the Locality field is too long.<\/td>\n<td>Occurs when the length of the Locality field value exceeds 250 characters.<\/td>\n<\/tr>\n<tr>\n<td>10<\/td>\n<td>The length of the AdministrativeArea field is too long.<\/td>\n<td>Occurs when the length of the AdministrativeArea field value exceeds 250 characters.<\/td>\n<\/tr>\n<tr>\n<td>11<\/td>\n<td>Locality and AdministrativeArea are required when a PostalCode is not provided.<\/td>\n<td>\u00a0<\/td>\n<\/tr>\n<tr>\n<td>12<\/td>\n<td>The length of the PostalCode field is too long.<\/td>\n<td>Occurs when the length of the PostalCode field value exceeds 50 characters.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<\/section>\n<section aria-labelledby=\"AVI-Errors-Errortype3:ServiceObjectsFatal\">\n<h2 id=\"AVI-Errors-Errortype3:ServiceObjectsFatal\">Error type 3: Service Objects Fatal<\/h2>\n<article aria-label=\"Description for Error Type 3: Service Objects Fatal\">\n<ul class=\"is-style-no-bullets-indented-list\">\n<li>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 International service, or a Network\/Connectivity issue.<\/li>\n<\/ul>\n<\/article>\n<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th scope=\"col\">DescCode<\/th>\n<th scope=\"col\">Desc<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>1<\/td>\n<td>Unhandled error. Please contact Service Objects.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<\/section>\n","protected":false},"excerpt":{"rendered":"<p>Error Types Error type 1: Authorization Error type 2: User Input Error type 3: Service Objects Fatal &nbsp; Anything that happens during a run of DOTS Address Validation International 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 [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":2200,"menu_order":5,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-2254","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>AVI - Errors<\/title>\n<meta name=\"description\" content=\"Error Types Error type 1: Authorization Error type 2: User Input Error type 3: Service Objects Fatal &nbsp; Anything that happens during a run of DOTS\" \/>\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-validation-international\/avi-errors\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"AVI - Errors\" \/>\n<meta property=\"og:description\" content=\"Error Types Error type 1: Authorization Error type 2: User Input Error type 3: Service Objects Fatal &nbsp; Anything that happens during a run of DOTS\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-international\/avi-errors\/\" \/>\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-22T15:06: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=\"3 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-validation-international\/avi-errors\/\",\"url\":\"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-international\/avi-errors\/\",\"name\":\"AVI - Errors\",\"isPartOf\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#website\"},\"datePublished\":\"2022-11-08T22:44:04+00:00\",\"dateModified\":\"2025-08-22T15:06:09+00:00\",\"description\":\"Error Types Error type 1: Authorization Error type 2: User Input Error type 3: Service Objects Fatal &nbsp; Anything that happens during a run of DOTS\",\"breadcrumb\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-international\/avi-errors\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-international\/avi-errors\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-international\/avi-errors\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.serviceobjects.com\/docs\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"DOTS Address Validation &#8211; International\",\"item\":\"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-international\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"AVI &#8211; Errors\"}]},{\"@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":"AVI - Errors","description":"Error Types Error type 1: Authorization Error type 2: User Input Error type 3: Service Objects Fatal &nbsp; Anything that happens during a run of DOTS","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-validation-international\/avi-errors\/","og_locale":"en_US","og_type":"article","og_title":"AVI - Errors","og_description":"Error Types Error type 1: Authorization Error type 2: User Input Error type 3: Service Objects Fatal &nbsp; Anything that happens during a run of DOTS","og_url":"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-international\/avi-errors\/","og_site_name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","article_modified_time":"2025-08-22T15:06:09+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-international\/avi-errors\/","url":"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-international\/avi-errors\/","name":"AVI - Errors","isPartOf":{"@id":"https:\/\/www.serviceobjects.com\/docs\/#website"},"datePublished":"2022-11-08T22:44:04+00:00","dateModified":"2025-08-22T15:06:09+00:00","description":"Error Types Error type 1: Authorization Error type 2: User Input Error type 3: Service Objects Fatal &nbsp; Anything that happens during a run of DOTS","breadcrumb":{"@id":"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-international\/avi-errors\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-international\/avi-errors\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-international\/avi-errors\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.serviceobjects.com\/docs\/"},{"@type":"ListItem","position":2,"name":"DOTS Address Validation &#8211; International","item":"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-international\/"},{"@type":"ListItem","position":3,"name":"AVI &#8211; Errors"}]},{"@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\/2254","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=2254"}],"version-history":[{"count":28,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/2254\/revisions"}],"predecessor-version":[{"id":12024,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/2254\/revisions\/12024"}],"up":[{"embeddable":true,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/2200"}],"wp:attachment":[{"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/media?parent=2254"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}