{"id":5592,"date":"2022-11-14T22:59:46","date_gmt":"2022-11-14T22:59:46","guid":{"rendered":"https:\/\/serviceobjects.wpaladdin.com\/?page_id=5592"},"modified":"2025-08-22T15:15:36","modified_gmt":"2025-08-22T22:15:36","slug":"nv2-errors","status":"publish","type":"page","link":"https:\/\/www.serviceobjects.com\/docs\/dots-name-validation-2\/nv2-errors\/","title":{"rendered":"NV2 &#8211; Errors"},"content":{"rendered":"<nav class=\"is-style-bullets-list\" aria-label=\"Error Types Navigation\">\n<ul>\n<li><a href=\"#NV2-Errors-ErrorTypes\">Error Types<\/a>\n<ul>\n<li><a href=\"#NV2-Errors-Errortype1:Authorization\">Error type 1: Authorization<\/a><\/li>\n<li><a href=\"#NV2-Errors-Errortype2:UserInput\">Error type 2: User Input<\/a><\/li>\n<li><a href=\"#NV2-Errors-Errortype3:ServiceObjectsFatal\">Error type 3: Service Objects Fatal<\/a><\/li>\n<li><a href=\"#NV2-Errors-Errortype4:DomainSpecific\">Error type 4: Domain Specific<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/nav>\n<div class=\"wp-block-spacer\" style=\"height: 30px;\" aria-hidden=\"true\"><\/div>\n<article aria-label=\"Error introduction\">Anything that happens during a run of DOTS Name Validation 2 that causes it to be unable to finish its normal processing is an error. If an error occurs, something like the following will be the result instead of the normal output:<\/article>\n<div class=\"wp-block-spacer\" style=\"height: 30px;\" aria-hidden=\"true\"><\/div>\n<h4><strong>Example:<\/strong><\/h4>\n<div class=\"wp-block-spacer\" style=\"height: 30px;\" aria-hidden=\"true\"><\/div>\n<figure class=\"wp-block-table is-style-regular\">\n<table>\n<tbody>\n<tr>\n<td><strong>*Error!*<\/strong><br \/>\n&lt;Type&gt;Authorization&lt;\/Type&gt;<br \/>\n&lt;TypeCode&gt;1&lt;\/TypeCode&gt;<br \/>\n&lt;Desc&gt;Your license key does not work on this service.<br \/>\n&lt;\/Desc&gt;<br \/>\n&lt;DescCode&gt;8&lt;\/DescCode&gt;<\/td>\n<\/tr>\n<\/tbody>\n<\/table><figcaption class=\"wp-element-caption\">There are four error types described below.<\/figcaption><\/figure>\n<section aria-labelledby=\"NV2-Errors-ErrorTypes\">\n<h2 id=\"NV2-Errors-ErrorTypes\">Error Types<\/h2>\n<div class=\"wp-block-spacer\" style=\"height: 30px;\" aria-hidden=\"true\"><\/div>\n<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th>Type<\/th>\n<th>TypeCode<\/th>\n<th>Billable<\/th>\n<th>Standard for 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>Yes<\/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<tr>\n<td>Domain Specific<\/td>\n<td>4<\/td>\n<td>Yes<\/td>\n<td>No<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<\/section>\n<section aria-labelledby=\"NV2-Errors-Errortype1:Authorization\">\n<h2 id=\"NV2-Errors-Errortype1:Authorization\">Error type 1: Authorization<\/h2>\n<div class=\"wp-block-spacer\" style=\"height: 30px;\" aria-hidden=\"true\"><\/div>\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<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th>DescCode<\/th>\n<th>Description<\/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.\u00a0 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<\/tbody>\n<\/table>\n<\/figure>\n<\/section>\n<section aria-labelledby=\"NV2-Errors-Errortype2:UserInput\">\n<h2 id=\"NV2-Errors-Errortype2:UserInput\">Error type 2: User Input<\/h2>\n<div class=\"wp-block-spacer\" style=\"height: 30px;\" aria-hidden=\"true\"><\/div>\n<ul class=\"is-style-no-bullets-indented-list\">\n<li>These errors occur as a result of bad input.\u00a0 DOTS Name Validation 2\u00a0requires a name to be present in order for a proper validation to take place.<\/li>\n<\/ul>\n<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th>DescCode<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>1<\/td>\n<td>You must input a name.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<\/section>\n<section aria-labelledby=\"NV2-Errors-Errortype3:ServiceObjectsFatal\">\n<h2 id=\"NV2-Errors-Errortype3:ServiceObjectsFatal\">Error type 3: Service Objects Fatal<\/h2>\n<div class=\"wp-block-spacer\" style=\"height: 30px;\" aria-hidden=\"true\"><\/div>\n<ul class=\"is-style-no-bullets-indented-list\">\n<li>The Desc will always be the same and the DescCode has no meaning.\u00a0 This is standard to all Generation 2 DOTS Web Services.\u00a0 This is a rare error that signals either a bug in the DOTS Name Validation 2\u00a0service or a Network\/Connectivity issue.<\/li>\n<\/ul>\n<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th>DescCode<\/th>\n<th>Description<\/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<section aria-labelledby=\"NV2-Errors-Errortype4:DomainSpecific\">\n<h2 id=\"NV2-Errors-Errortype4:DomainSpecific\">Error type 4: Domain Specific<\/h2>\n<div class=\"wp-block-spacer\" style=\"height: 30px;\" aria-hidden=\"true\"><\/div>\n<ul class=\"is-style-no-bullets-indented-list\">\n<li>Domain specific errors represent the normal errors seen in Service Objects services.\u00a0 For example, if the user is looking for an address in DOTS Address Validation and the address does not exist, a valid domain specific error is &#8220;Address not found.&#8221;<\/li>\n<\/ul>\n<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th>DescCode<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>1<\/td>\n<td>An issue occurred during name parsing.<\/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 Error type 4: Domain Specific Anything that happens during a run of DOTS Name Validation 2 that causes it to be unable to finish its normal processing is an error. If an error occurs, something like the following [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":5254,"menu_order":2,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-5592","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>NV2 - 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=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.serviceobjects.com\/docs\/dots-name-validation-2\/nv2-errors\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"NV2 - 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:\/\/www.serviceobjects.com\/docs\/dots-name-validation-2\/nv2-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-22T22:15:36+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-name-validation-2\/nv2-errors\/\",\"url\":\"https:\/\/www.serviceobjects.com\/docs\/dots-name-validation-2\/nv2-errors\/\",\"name\":\"NV2 - Errors\",\"isPartOf\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#website\"},\"datePublished\":\"2022-11-14T22:59:46+00:00\",\"dateModified\":\"2025-08-22T22:15:36+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:\/\/www.serviceobjects.com\/docs\/dots-name-validation-2\/nv2-errors\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.serviceobjects.com\/docs\/dots-name-validation-2\/nv2-errors\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/dots-name-validation-2\/nv2-errors\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.serviceobjects.com\/docs\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"DOTS Name Validation 2\",\"item\":\"https:\/\/www.serviceobjects.com\/docs\/dots-name-validation-2\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"NV2 &#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":"NV2 - 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":"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-name-validation-2\/nv2-errors\/","og_locale":"en_US","og_type":"article","og_title":"NV2 - 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:\/\/www.serviceobjects.com\/docs\/dots-name-validation-2\/nv2-errors\/","og_site_name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","article_modified_time":"2025-08-22T22:15:36+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-name-validation-2\/nv2-errors\/","url":"https:\/\/www.serviceobjects.com\/docs\/dots-name-validation-2\/nv2-errors\/","name":"NV2 - Errors","isPartOf":{"@id":"https:\/\/www.serviceobjects.com\/docs\/#website"},"datePublished":"2022-11-14T22:59:46+00:00","dateModified":"2025-08-22T22:15:36+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:\/\/www.serviceobjects.com\/docs\/dots-name-validation-2\/nv2-errors\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.serviceobjects.com\/docs\/dots-name-validation-2\/nv2-errors\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.serviceobjects.com\/docs\/dots-name-validation-2\/nv2-errors\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.serviceobjects.com\/docs\/"},{"@type":"ListItem","position":2,"name":"DOTS Name Validation 2","item":"https:\/\/www.serviceobjects.com\/docs\/dots-name-validation-2\/"},{"@type":"ListItem","position":3,"name":"NV2 &#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\/5592","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\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/comments?post=5592"}],"version-history":[{"count":14,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/5592\/revisions"}],"predecessor-version":[{"id":11974,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/5592\/revisions\/11974"}],"up":[{"embeddable":true,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/5254"}],"wp:attachment":[{"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/media?parent=5592"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}