{"id":9749,"date":"2023-08-09T13:20:32","date_gmt":"2023-08-09T20:20:32","guid":{"rendered":"https:\/\/www.serviceobjects.com\/docs\/?page_id=9749"},"modified":"2025-08-22T15:14:35","modified_gmt":"2025-08-22T22:14:35","slug":"tv-errors","status":"publish","type":"page","link":"https:\/\/www.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-errors\/","title":{"rendered":"TV &#8211; Errors"},"content":{"rendered":"<nav class=\"wp-block-list\" aria-label=\"Error Types Navigation\">\n<ul>\n<li><a href=\"#TV-Errors-ErrorTypes\">Error Types<\/a>\n<ul>\n<li><a href=\"#TV-Errors-Errortype1:Authorization\">Error type 1: Authorization<\/a><\/li>\n<li><a href=\"#TV-Errors-Errortype2:UserInput\">Error type 2: User Input<\/a><\/li>\n<li><a href=\"#TV-Errors-Errortype3:ServiceObjectsFatal\">Error type 3: Service Objects Fatal<\/a><\/li>\n<li><a href=\"#TV-Errors-Errortype4:DomainSpecific\">Error type 4: Domain Specific<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/nav>\n<article class=\"wp-block-paragraph\" aria-label=\"General error definition\">Generally, an error is anything that happens during execution of DOTS Telephone Verification that causes the service to fail. The source of these errors may be user input, license key transaction limits, timeouts, and unexpected circumstances. Applications should expect and handle any and all errors appropriately. Occasionally, new error types or descriptions may be introduced to the web service as new features and data sources are implemented. Description strings may change slightly, so use the description code to determine which error has occurred. Errors are organized into types, listed in the table below.<\/article>\n<article class=\"wp-block-paragraph\" aria-label=\"Overview of four error types\">There are four error types described below.<\/article>\n<section aria-labelledby=\"TV-Errors-ErrorTypes\">\n<h2 id=\"TV-Errors-ErrorTypes\" class=\"wp-block-heading\">Error Types<\/h2>\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 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=\"TV-Errors-Errortype1:Authorization\">\n<h2 id=\"TV-Errors-Errortype1:Authorization\" class=\"wp-block-heading\">Error type 1: Authorization<\/h2>\n<article class=\"wp-block-paragraph\" aria-label=\"Explanation of authorization error\">The Error object appears under the main return object. Below is an example of the error returned when the PlaceCall operation is accessed without a valid license key<\/article>\n<figure class=\"wp-block-table is-style-regular\">\n<table>\n<tbody>\n<tr>\n<td><strong>*Error!*<\/strong><br \/>\n&lt;Error&gt;<br \/>\n&lt;Type&gt;Authorization&lt;\/Type&gt;<br \/>\n&lt;TypeCode&gt;1&lt;\/TypeCode&gt;<br \/>\n&lt;Desc&gt;Please provide a valid license key for this web service.&lt;\/Desc&gt;<br \/>\n&lt;DescCode&gt;1&lt;\/DescCode&gt;<br \/>\n&lt;\/Error&gt;<br \/>\n&lt;\/TelephoneInfo&gt;<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<pre class=\"wp-block-code\"><code>\r\n<\/code><\/pre>\n<\/figure>\n<\/section>\n<section aria-labelledby=\"TV-Errors-Errortype2:UserInput\">\n<h2 id=\"TV-Errors-Errortype2:UserInput\" class=\"wp-block-heading\">Error type 2: User Input<\/h2>\n<article class=\"wp-block-paragraph\" aria-label=\"Explanation of user input error\">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.<\/article>\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>Please enter a valid CountryCode plus PhoneNumber combination.<\/td>\n<\/tr>\n<tr>\n<td>2<\/td>\n<td>PlaceCall is not enabled for this CountryCode and PhoneNumber combination<\/td>\n<\/tr>\n<tr>\n<td>3<\/td>\n<td>Please enter a valid 10-digit ph one number for the CallerID field.<\/td>\n<\/tr>\n<tr>\n<td>4<\/td>\n<td>Please enter a valid extension consisting of digits and the &#8216;w&#8217; character.<\/td>\n<\/tr>\n<tr>\n<td>5<\/td>\n<td>Please enter a valid extension pause time in whole seconds.<\/td>\n<\/tr>\n<tr>\n<td>6<\/td>\n<td>Please use a supported language code. Currently supported languages: (varies)<\/td>\n<\/tr>\n<tr>\n<td>7<\/td>\n<td>VerificationCode must be an empty string or a string of 3 (varies) digits.<\/td>\n<\/tr>\n<tr>\n<td>8<\/td>\n<td>VerificationCode must be a string of 3-6 (varies) digits.<\/td>\n<\/tr>\n<tr>\n<td>9<\/td>\n<td>SendSMS is not enabled for this CountryCode and PhoneNumber combination<\/td>\n<\/tr>\n<tr>\n<td>10<\/td>\n<td>Please enter a valid message between 1 and 140 characters long.<\/td>\n<\/tr>\n<tr>\n<td>11<\/td>\n<td>Please enter a valid 10-digit phone number for the PhoneNumber field<\/td>\n<\/tr>\n<tr>\n<td>12<\/td>\n<td>TransactionID does not exist.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<article class=\"wp-block-paragraph\" aria-label=\"Deprecated description codes note\">*Deprecated DescCode that are no longer used.<\/article>\n<\/section>\n<section aria-labelledby=\"TV-Errors-Errortype3:ServiceObjectsFatal\">\n<h2 id=\"TV-Errors-Errortype3:ServiceObjectsFatal\" class=\"wp-block-heading\">Error type 3: Service Objects Fatal<\/h2>\n<article class=\"wp-block-paragraph\" aria-label=\"Explanation of service objects fatal error\">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.<\/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<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>1<\/td>\n<td>Database error retrieving country code information.<\/td>\n<\/tr>\n<tr>\n<td>2<\/td>\n<td>Error placing call in primary queue<\/td>\n<\/tr>\n<tr>\n<td>3<\/td>\n<td>Error placing call in secondary queue.<\/td>\n<\/tr>\n<tr>\n<td>4<\/td>\n<td>Error sending message to primary SMS provider.<\/td>\n<\/tr>\n<tr>\n<td>5<\/td>\n<td>Error sending message to secondary SMS provider.<\/td>\n<\/tr>\n<tr>\n<td>?<\/td>\n<td>Other error occurred. Contact Service Objects<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<\/section>\n<section aria-labelledby=\"TV-Errors-Errortype4:DomainSpecific\">\n<h2 id=\"TV-Errors-Errortype4:DomainSpecific\" class=\"wp-block-heading\">Error type 4: Domain Specific<\/h2>\n<article class=\"wp-block-paragraph\" aria-label=\"Explanation of domain specific error\">Domain specific errors represent the common errors seen in Service Objects services.<\/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<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>1<\/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 execution of DOTS Telephone Verification that causes the service to fail. The source of these errors may be user input, license key transaction limits, timeouts, [&hellip;]<\/p>\n","protected":false},"author":22,"featured_media":0,"parent":9741,"menu_order":2,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-9749","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>TV - 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-telephone-verification-tv\/tv-errors\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"TV - 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-telephone-verification-tv\/tv-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:14:35+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-telephone-verification-tv\/tv-errors\/\",\"url\":\"https:\/\/www.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-errors\/\",\"name\":\"TV - Errors\",\"isPartOf\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#website\"},\"datePublished\":\"2023-08-09T20:20:32+00:00\",\"dateModified\":\"2025-08-22T22:14:35+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-telephone-verification-tv\/tv-errors\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-errors\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-errors\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.serviceobjects.com\/docs\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"DOTS Telephone Verification\",\"item\":\"https:\/\/www.serviceobjects.com\/docs\/dots-telephone-verification-tv\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"TV &#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":"TV - 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-telephone-verification-tv\/tv-errors\/","og_locale":"en_US","og_type":"article","og_title":"TV - 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-telephone-verification-tv\/tv-errors\/","og_site_name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","article_modified_time":"2025-08-22T22:14:35+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-telephone-verification-tv\/tv-errors\/","url":"https:\/\/www.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-errors\/","name":"TV - Errors","isPartOf":{"@id":"https:\/\/www.serviceobjects.com\/docs\/#website"},"datePublished":"2023-08-09T20:20:32+00:00","dateModified":"2025-08-22T22:14:35+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-telephone-verification-tv\/tv-errors\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-errors\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-errors\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.serviceobjects.com\/docs\/"},{"@type":"ListItem","position":2,"name":"DOTS Telephone Verification","item":"https:\/\/www.serviceobjects.com\/docs\/dots-telephone-verification-tv\/"},{"@type":"ListItem","position":3,"name":"TV &#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\/9749","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\/22"}],"replies":[{"embeddable":true,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/comments?post=9749"}],"version-history":[{"count":8,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/9749\/revisions"}],"predecessor-version":[{"id":11972,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/9749\/revisions\/11972"}],"up":[{"embeddable":true,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/9741"}],"wp:attachment":[{"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/media?parent=9749"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}