{"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":"2023-08-09T13:20:32","modified_gmt":"2023-08-09T20:20:32","slug":"tv-errors","status":"publish","type":"page","link":"https:\/\/test.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-errors\/","title":{"rendered":"TV &#8211; Errors"},"content":{"rendered":"\n<ul class=\"wp-block-list\">\n<li><a href=\"#TV-Errors-ErrorTypes\">Error Types<\/a>\n<ul class=\"wp-block-list\">\n<li><a href=\"#TV-Errors-Errortype1:Authorization\">Error type 1: Authorization<\/a><\/li>\n\n\n\n<li><a href=\"#TV-Errors-Errortype2:UserInput\">Error type 2: User Input<\/a><\/li>\n\n\n\n<li><a href=\"#TV-Errors-Errortype3:ServiceObjectsFatal\">Error type 3: Service Objects Fatal<\/a><\/li>\n\n\n\n<li><a href=\"#TV-Errors-Errortype4:DomainSpecific\">Error type 4: Domain Specific<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<p>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.<\/p>\n\n\n\n<p><br>There are four error types described below.<\/p>\n\n\n\n<h1 class=\"wp-block-heading\" id=\"TV-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>Yes<\/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=\"TV-Errors-Errortype1:Authorization\">Error type 1: Authorization<\/h2>\n\n\n\n<p>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<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;TelephoneInfo&gt;\n&lt;Error&gt;\n&lt;Type&gt;Authorization&lt;\/Type&gt;\n&lt;TypeCode&gt;1&lt;\/TypeCode&gt;\n&lt;Desc&gt;Please provide a valid license key for this web service.&lt;\/Desc&gt;\n&lt;DescCode&gt;1&lt;\/DescCode&gt;\n&lt;\/Error&gt;\n&lt;\/TelephoneInfo&gt;<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"TV-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>Description<\/th><\/tr><\/thead><tbody><tr><td>1<\/td><td>Please enter a valid CountryCode plus PhoneNumber combination.<\/td><\/tr><tr><td>2<\/td><td>PlaceCall is not enabled for this CountryCode and PhoneNumber combination<\/td><\/tr><tr><td>3<\/td><td>Please enter a valid 10-digit ph one number for the CallerID field.<\/td><\/tr><tr><td>4<\/td><td>Please enter a valid extension consisting of digits and the &#8216;w&#8217; character.<\/td><\/tr><tr><td>5<\/td><td>Please enter a valid extension pause time in whole seconds.<\/td><\/tr><tr><td>6<\/td><td>Please use a supported language code. Currently supported languages: (varies)<\/td><\/tr><tr><td>7<\/td><td>VerificationCode must be an empty string or a string of 3 (varies) digits.<\/td><\/tr><tr><td>8<\/td><td>VerificationCode must be a string of 3-6 (varies) digits.<\/td><\/tr><tr><td>9<\/td><td>SendSMS is not enabled for this CountryCode and PhoneNumber combination<\/td><\/tr><tr><td>10<\/td><td>Please enter a valid message between 1 and 140 characters long.<\/td><\/tr><tr><td>11<\/td><td>Please enter a valid 10-digit phone number for the PhoneNumber field<\/td><\/tr><tr><td>12<\/td><td>TransactionID does not exist.<\/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=\"TV-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>Database error retrieving country code information.<\/td><\/tr><tr><td>2<\/td><td>Error placing call in primary queue<\/td><\/tr><tr><td>3<\/td><td>Error placing call in secondary queue.<\/td><\/tr><tr><td>4<\/td><td>Error sending message to primary SMS provider.<\/td><\/tr><tr><td>5<\/td><td>Error sending message to secondary SMS provider.<\/td><\/tr><tr><td>?<\/td><td>Other error occurred. Contact Service Objects<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"TV-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. <\/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>Operation Not Supported<\/td><\/tr><\/tbody><\/table><\/figure>\n","protected":false},"excerpt":{"rendered":"<p>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 [&hellip;]<\/p>\n","protected":false},"author":22,"featured_media":0,"parent":9741,"menu_order":2,"comment_status":"open","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 v24.7 - 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=\"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=\"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:\/\/test.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 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-telephone-verification-tv\/tv-errors\/\",\"url\":\"https:\/\/test.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-errors\/\",\"name\":\"TV - Errors\",\"isPartOf\":{\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/#website\"},\"datePublished\":\"2023-08-09T20:20:32+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:\/\/test.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-errors\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/test.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-errors\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-errors\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/test.serviceobjects.com\/docs\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"DOTS Telephone Verification\",\"item\":\"https:\/\/test.serviceobjects.com\/docs\/dots-telephone-verification-tv\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"TV &#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":"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":"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":"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:\/\/test.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-errors\/","og_site_name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","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-telephone-verification-tv\/tv-errors\/","url":"https:\/\/test.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-errors\/","name":"TV - Errors","isPartOf":{"@id":"https:\/\/test.serviceobjects.com\/docs\/#website"},"datePublished":"2023-08-09T20:20:32+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:\/\/test.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-errors\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/test.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-errors\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/test.serviceobjects.com\/docs\/dots-telephone-verification-tv\/tv-errors\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/test.serviceobjects.com\/docs\/"},{"@type":"ListItem","position":2,"name":"DOTS Telephone Verification","item":"https:\/\/test.serviceobjects.com\/docs\/dots-telephone-verification-tv\/"},{"@type":"ListItem","position":3,"name":"TV &#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\/9749","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\/22"}],"replies":[{"embeddable":true,"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/comments?post=9749"}],"version-history":[{"count":3,"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/9749\/revisions"}],"predecessor-version":[{"id":9822,"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/9749\/revisions\/9822"}],"up":[{"embeddable":true,"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/9741"}],"wp:attachment":[{"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/media?parent=9749"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}