{"id":5098,"date":"2022-11-13T20:10:06","date_gmt":"2022-11-13T20:10:06","guid":{"rendered":"https:\/\/serviceobjects.wpaladdin.com\/?page_id=5098"},"modified":"2025-08-21T08:29:28","modified_gmt":"2025-08-21T15:29:28","slug":"pa2-errors","status":"publish","type":"page","link":"https:\/\/www.serviceobjects.com\/docs\/dots-phone-append-2\/pa2-errors\/","title":{"rendered":"PA2 &#8211; Errors"},"content":{"rendered":"<nav class=\"is-style-bullets-list\" aria-label=\"Error Navigation\">\n<ul>\n<li><a href=\"#PA2-Errors-ErrorTypes\">Error Types<\/a>\n<ul>\n<li><a href=\"#PA2-Errors-Errortype1:Authorization\">Error type 1: Authorization<\/a><\/li>\n<li><a href=\"#PA2-Errors-Errortype2:UserInput\">Error type 2: User Input<\/a><\/li>\n<li><a href=\"#PA2-Errors-Errortype3:ServiceObjectsFatal\">Error type 3: Service Objects Fatal<\/a><\/li>\n<li><a href=\"#PA2-Errors-Errortype4:DomainSpecific\">Error type 4: Domain Specific<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/nav>\n<div style=\"height:30px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n<article aria-label=\"General error description\">\n  Generally, an error is anything that happens during a run of DOTS Phone Append 2 that causes the service to fail. If an error occurs, an XML error message, similar to the one below, will result instead of the PhoneInfoResult output described above:<br \/>\n<\/article>\n<div style=\"height:30px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n<article aria-label=\"Example error output\">\n  <strong>Example:<\/strong><br \/>\n<\/article>\n<p>&nbsp;<\/p>\n<figure class=\"wp-block-table is-style-regular\">\n<table>\n<tbody>\n<tr>\n<td><\/td>\n<td><strong>*Error!*<\/strong><br \/>&nbsp; &lt;Type&gt;Authorization&lt;\/Type&gt;<br \/>&nbsp; &lt;TypeCode&gt;1&lt;\/TypeCode&gt;<br \/>&nbsp; &lt;Desc&gt;Your license key does not work on this service.&lt;\/Desc&gt;<br \/>&nbsp; &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=\"PA2-Errors-ErrorTypes\">\n<h2 id=\"PA2-Errors-ErrorTypes\">Error Types<\/h2>\n<p>  &nbsp;<\/p>\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>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=\"PA2-Errors-Errortype1:Authorization\">\n<h2 id=\"PA2-Errors-Errortype1:Authorization\">Error type 1: Authorization<\/h2>\n<p>  &nbsp;<\/p>\n<ul class=\"is-style-no-bullets-indented-list\">\n<li>These 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 scope=\"col\">Desc Code<\/th>\n<th scope=\"col\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>0<\/td>\n<td>Please provide a valid license key for this web service.<\/td>\n<\/tr>\n<tr>\n<td>1<\/td>\n<td>The daily allowable number of transactions for this license key has been exceeded.<\/td>\n<\/tr>\n<tr>\n<td>2<\/td>\n<td>The monthly allowable number of transactions for this license key has been exceeded.<\/td>\n<\/tr>\n<tr>\n<td>3<\/td>\n<td>The total allowable number of transactions for this license key has been exceeded.<\/td>\n<\/tr>\n<tr>\n<td>4<\/td>\n<td>There are not enough transactions available. Check your daily\/monthly transaction limits.<\/td>\n<\/tr>\n<tr>\n<td>5<\/td>\n<td>This license key has expired.<\/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 operation is limited to specific usage. Please contact customer service to have your key<br \/>enabled.<\/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=\"PA2-Errors-Errortype2:UserInput\">\n<h2 id=\"PA2-Errors-Errortype2:UserInput\">Error type 2: User Input<\/h2>\n<p>  &nbsp;<\/p>\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<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th scope=\"col\">Desc Code<\/th>\n<th scope=\"col\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>1<\/td>\n<td>Please enter a LicenseKey.<\/td>\n<\/tr>\n<tr>\n<td>2<\/td>\n<td>Please enter a City\/State or PostalCode.<\/td>\n<\/tr>\n<tr>\n<td>3<\/td>\n<td>Please provide a name.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<\/section>\n<section aria-labelledby=\"PA2-Errors-Errortype3:ServiceObjectsFatal\">\n<h2 id=\"PA2-Errors-Errortype3:ServiceObjectsFatal\">Error type 3: Service Objects Fatal<\/h2>\n<p>  &nbsp;<\/p>\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 an application fault in the DOTS Phone Append 2 service 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 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<section aria-labelledby=\"PA2-Errors-Errortype4:DomainSpecific\">\n<h2 id=\"PA2-Errors-Errortype4:DomainSpecific\">Error type 4: Domain Specific<\/h2>\n<p>  &nbsp;<\/p>\n<ul class=\"is-style-no-bullets-indented-list\">\n<li>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.<\/li>\n<\/ul>\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\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>1<\/td>\n<td>No phone number found for the given criteria.<\/td>\n<\/tr>\n<tr>\n<td>2<\/td>\n<td>Bad address information. Required fields: City\/state or Postal Code are missing.<\/td>\n<\/tr>\n<tr>\n<td>3<\/td>\n<td>Operation not supported.<\/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 Generally, an error is anything that happens during a run of DOTS Phone Append 2 that causes the service to fail. If an error occurs, an XML error message, similar to the one [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":4729,"menu_order":1,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-5098","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>PA2 - 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 Generally, an error is\" \/>\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-phone-append-2\/pa2-errors\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"PA2 - 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 Generally, an error is\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.serviceobjects.com\/docs\/dots-phone-append-2\/pa2-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-21T15:29:28+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-phone-append-2\/pa2-errors\/\",\"url\":\"https:\/\/www.serviceobjects.com\/docs\/dots-phone-append-2\/pa2-errors\/\",\"name\":\"PA2 - Errors\",\"isPartOf\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#website\"},\"datePublished\":\"2022-11-13T20:10:06+00:00\",\"dateModified\":\"2025-08-21T15:29:28+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 Generally, an error is\",\"breadcrumb\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/dots-phone-append-2\/pa2-errors\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.serviceobjects.com\/docs\/dots-phone-append-2\/pa2-errors\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/dots-phone-append-2\/pa2-errors\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.serviceobjects.com\/docs\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"DOTS Phone Append 2\",\"item\":\"https:\/\/www.serviceobjects.com\/docs\/dots-phone-append-2\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"PA2 &#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":"PA2 - Errors","description":"Error Types Error type 1: Authorization Error type 2: User Input Error type 3: Service Objects Fatal Error type 4: Domain Specific Generally, an error is","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-phone-append-2\/pa2-errors\/","og_locale":"en_US","og_type":"article","og_title":"PA2 - 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 Generally, an error is","og_url":"https:\/\/www.serviceobjects.com\/docs\/dots-phone-append-2\/pa2-errors\/","og_site_name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","article_modified_time":"2025-08-21T15:29:28+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-phone-append-2\/pa2-errors\/","url":"https:\/\/www.serviceobjects.com\/docs\/dots-phone-append-2\/pa2-errors\/","name":"PA2 - Errors","isPartOf":{"@id":"https:\/\/www.serviceobjects.com\/docs\/#website"},"datePublished":"2022-11-13T20:10:06+00:00","dateModified":"2025-08-21T15:29:28+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 Generally, an error is","breadcrumb":{"@id":"https:\/\/www.serviceobjects.com\/docs\/dots-phone-append-2\/pa2-errors\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.serviceobjects.com\/docs\/dots-phone-append-2\/pa2-errors\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.serviceobjects.com\/docs\/dots-phone-append-2\/pa2-errors\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.serviceobjects.com\/docs\/"},{"@type":"ListItem","position":2,"name":"DOTS Phone Append 2","item":"https:\/\/www.serviceobjects.com\/docs\/dots-phone-append-2\/"},{"@type":"ListItem","position":3,"name":"PA2 &#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\/5098","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=5098"}],"version-history":[{"count":7,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/5098\/revisions"}],"predecessor-version":[{"id":11669,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/5098\/revisions\/11669"}],"up":[{"embeddable":true,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/4729"}],"wp:attachment":[{"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/media?parent=5098"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}