{"id":5411,"date":"2022-11-14T17:17:48","date_gmt":"2022-11-14T17:17:48","guid":{"rendered":"https:\/\/serviceobjects.wpaladdin.com\/?page_id=5411"},"modified":"2025-08-21T11:24:15","modified_gmt":"2025-08-21T18:24:15","slug":"ur-errors","status":"publish","type":"page","link":"https:\/\/www.serviceobjects.com\/docs\/dots-usage-report\/ur-errors\/","title":{"rendered":"UR &#8211; Errors"},"content":{"rendered":"<nav aria-label=\"Error Codes Navigation\">\n<ul class=\"is-style-bullets-list\">\n<li><a href=\"#ErrorCode1\">Error Code 1 \u2013 &#8220;Input cannot be less than zero length&#8221;<\/a><\/li>\n<li><a href=\"#ErrorCode2\">Error Code 2 \u2013 Various descriptions<\/a><\/li>\n<li><a href=\"#ErrorCode3-4-5\">Error Code 3\/4\/5 \u2013 Various descriptions<\/a><\/li>\n<\/ul>\n<\/nav>\n<p> &nbsp;<\/p>\n<section aria-labelledby=\"ErrorCodesIntro\">\n<article aria-label=\"General Error Description\">\n<p id=\"ErrorCodesIntro\">Generally, an error is anything that happens during execution of DOTS&nbsp;Usage Reports&nbsp;that causes the service to fail. The source of these errors may be user input, license key transaction limits, timeouts, and unexpected circumstances.&nbsp;<strong>Applications should expect and handle any and all errors appropriately.<\/strong>&nbsp;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<\/article>\n<p>  &nbsp;<\/p>\n<article aria-label=\"Example Error Object Explanation\">\n<p>The Error object appears under the main return object. Below is an example of the error returned when the&nbsp;<a href=\"..\/ur-operations\/ur-getdotstransactiondetailsbydaterange-recommended\/\">GetDOTSTransactionDetailsByDateRange&nbsp;<\/a>operation is accessed without a valid license key.<\/p>\n<\/article>\n<p>  &nbsp;<\/p>\n<article aria-label=\"Example Label\">\n<p><strong>Example:<\/strong><\/p>\n<\/article>\n<figure class=\"wp-block-table is-style-regular\">\n<table class=\"has-fixed-layout\">\n<tbody>\n<tr>\n<td>\n            <code>&lt;<mark style=\"color:#336699\" class=\"has-inline-color\"><strong>ReportTransactionDetailUsage<\/strong><\/mark>&gt;<\/code><br \/>\n            <code>&lt;<mark style=\"color:#336699\" class=\"has-inline-color\"><strong>Error<\/strong><\/mark>&gt;<\/code><br \/>\n            <code>&lt;<mark style=\"color:#336699\" class=\"has-inline-color\"><strong>Desc<\/strong><\/mark>&gt;License key and e-mail do not match our records.&lt;\/<mark style=\"color:#336699\" class=\"has-inline-color\"><strong>Desc<\/strong><\/mark>&gt;<\/code><br \/>\n            <code>&lt;<mark style=\"color:#336699\" class=\"has-inline-color\"><strong>Number<\/strong><\/mark>&gt;2&lt;\/<mark style=\"color:#336699\" class=\"has-inline-color\"><strong>Number<\/strong><\/mark>&gt;<\/code><br \/>\n            <code>&lt;\/<mark style=\"color:#336699\" class=\"has-inline-color\"><strong>Error<\/strong><\/mark>&gt;<\/code><br \/>\n            <code>&lt;\/<mark style=\"color:#336699\" class=\"has-inline-color\"><strong>ReportTransactionDetailUsage<\/strong><\/mark>&gt;<\/code>\n          <\/td>\n<\/tr>\n<\/tbody>\n<\/table><figcaption class=\"wp-element-caption\">Error codes in Usage Reports are the same for all operations.<\/figcaption><\/figure>\n<\/section>\n<section aria-labelledby=\"ErrorCode1\">\n<h2 id=\"ErrorCode1\">Error Code 1 \u2013 &#8220;Input cannot be less than zero length&#8221;<\/h2>\n<p>  &nbsp;<\/p>\n<ul class=\"is-style-no-bullets-indented-list\">\n<li>This error means the web service did not get any input. The connection to the service was made, and data was transferred, but no parameters were passed that the service could understand.&nbsp;<\/li>\n<li>This error often happens when the input is passed to the service with namespaces that the service does not understand. Applying a namespace to any of the parameters (Address, City, State, etc.) will cause this error. Additionally, requests made in the &#8220;rpc\/encoded&#8221; format will cause this error. The only namespace that should appear in any element is the &#8220;<a rel=\"noreferrer noopener\" href=\"https:\/\/www.serviceobjects.com\/\" target=\"_blank\">https:\/\/www.serviceobjects.com<\/a>&#8221; namespace on the root Validate* element as so:<\/li>\n<\/ul>\n<p>  &nbsp;<\/p>\n<figure class=\"wp-block-table is-style-regular\">\n<table class=\"has-fixed-layout\">\n<tbody>\n<tr>\n<td><code>&lt;<\/code><strong><code><mark style=\"color:#336699\" class=\"has-inline-color\">ReportTransactionDetailUsage<\/mark><\/code><\/strong><code> xmlns=\"https:\/\/www.serviceobjects.com\/\"&gt;<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<p>  &nbsp;<\/p>\n<ul class=\"is-style-no-bullets-indented-list\">\n<li><strong>Note, however, that the namespace is not applied to the ReportTransactionDetailUsage element, it is only present.<\/strong><\/li>\n<\/ul>\n<\/section>\n<section aria-labelledby=\"ErrorCode2\">\n<h2 id=\"ErrorCode2\">Error Code 2 \u2013 Various descriptions<\/h2>\n<p>  &nbsp;<\/p>\n<ul class=\"is-style-no-bullets-indented-list\">\n<li>This error code appears when various errors occur but are of the expected nature. Oftentimes, maligned or incomplete input will cause an error 2.&nbsp;<br \/>The following is a list of the possible Error Descriptions that may accompany an Error Code 2:<\/li>\n<\/ul>\n<p>  &nbsp;<\/p>\n<ul class=\"is-style-no-bullets-indented-list\">\n<li><em>Bad or Incomplete GETDOTSTransaction Errors<\/em><\/li>\n<\/ul>\n<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th scope=\"col\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>License Key is required.<\/td>\n<\/tr>\n<tr>\n<td>Email is required.<\/td>\n<\/tr>\n<tr>\n<td>License key and email do not match our records.<\/td>\n<\/tr>\n<tr>\n<td>A valid Date is required.<\/td>\n<\/tr>\n<tr>\n<td>Please enter a valid date range.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<ul class=\"is-style-no-bullets-indented-list\">\n<li><em>Failed Authentication Errors:<\/em><\/li>\n<\/ul>\n<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th scope=\"col\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Please provide a valid license key for this web service.<\/td>\n<\/tr>\n<tr>\n<td>This license key has expired.<\/td>\n<\/tr>\n<tr>\n<td>This license key has not yet been activated.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<ul class=\"is-style-no-bullets-indented-list\">\n<li><em>Web Service Invocation Errors:<\/em><\/li>\n<\/ul>\n<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th scope=\"col\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Error initializing service.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<\/section>\n<section aria-labelledby=\"ErrorCode3-4-5\">\n<h2 id=\"ErrorCode3-4-5\">Error Code 3\/4\/5 \u2013 Various descriptions<\/h2>\n<ul class=\"is-style-no-bullets-indented-list\">\n<li>An error code 3, 4, or 5 is a fatal error and it means something serious has gone wrong. You will never see one of these error codes in a live production environment.<\/li>\n<\/ul>\n<\/section>\n","protected":false},"excerpt":{"rendered":"<p>Error Code 1 \u2013 &#8220;Input cannot be less than zero length&#8221; Error Code 2 \u2013 Various descriptions Error Code 3\/4\/5 \u2013 Various descriptions &nbsp; Generally, an error is anything that happens during execution of DOTS&nbsp;Usage Reports&nbsp;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":1,"featured_media":0,"parent":5395,"menu_order":1,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-5411","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>UR - Errors<\/title>\n<meta name=\"description\" content=\"Error Code 1 \u2013 &quot;Input cannot be less than zero length&quot; Error Code 2 \u2013 Various descriptions Error Code 3\/4\/5 \u2013 Various descriptions &nbsp; Generally, an\" \/>\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-usage-report\/ur-errors\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"UR - Errors\" \/>\n<meta property=\"og:description\" content=\"Error Code 1 \u2013 &quot;Input cannot be less than zero length&quot; Error Code 2 \u2013 Various descriptions Error Code 3\/4\/5 \u2013 Various descriptions &nbsp; Generally, an\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.serviceobjects.com\/docs\/dots-usage-report\/ur-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-21T18:24:15+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-usage-report\/ur-errors\/\",\"url\":\"https:\/\/www.serviceobjects.com\/docs\/dots-usage-report\/ur-errors\/\",\"name\":\"UR - Errors\",\"isPartOf\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#website\"},\"datePublished\":\"2022-11-14T17:17:48+00:00\",\"dateModified\":\"2025-08-21T18:24:15+00:00\",\"description\":\"Error Code 1 \u2013 \\\"Input cannot be less than zero length\\\" Error Code 2 \u2013 Various descriptions Error Code 3\/4\/5 \u2013 Various descriptions &nbsp; Generally, an\",\"breadcrumb\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/dots-usage-report\/ur-errors\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.serviceobjects.com\/docs\/dots-usage-report\/ur-errors\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/dots-usage-report\/ur-errors\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.serviceobjects.com\/docs\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"DOTS Usage Report\",\"item\":\"https:\/\/www.serviceobjects.com\/docs\/dots-usage-report\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"UR &#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":"UR - Errors","description":"Error Code 1 \u2013 \"Input cannot be less than zero length\" Error Code 2 \u2013 Various descriptions Error Code 3\/4\/5 \u2013 Various descriptions &nbsp; Generally, an","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-usage-report\/ur-errors\/","og_locale":"en_US","og_type":"article","og_title":"UR - Errors","og_description":"Error Code 1 \u2013 \"Input cannot be less than zero length\" Error Code 2 \u2013 Various descriptions Error Code 3\/4\/5 \u2013 Various descriptions &nbsp; Generally, an","og_url":"https:\/\/www.serviceobjects.com\/docs\/dots-usage-report\/ur-errors\/","og_site_name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","article_modified_time":"2025-08-21T18:24:15+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-usage-report\/ur-errors\/","url":"https:\/\/www.serviceobjects.com\/docs\/dots-usage-report\/ur-errors\/","name":"UR - Errors","isPartOf":{"@id":"https:\/\/www.serviceobjects.com\/docs\/#website"},"datePublished":"2022-11-14T17:17:48+00:00","dateModified":"2025-08-21T18:24:15+00:00","description":"Error Code 1 \u2013 \"Input cannot be less than zero length\" Error Code 2 \u2013 Various descriptions Error Code 3\/4\/5 \u2013 Various descriptions &nbsp; Generally, an","breadcrumb":{"@id":"https:\/\/www.serviceobjects.com\/docs\/dots-usage-report\/ur-errors\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.serviceobjects.com\/docs\/dots-usage-report\/ur-errors\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.serviceobjects.com\/docs\/dots-usage-report\/ur-errors\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.serviceobjects.com\/docs\/"},{"@type":"ListItem","position":2,"name":"DOTS Usage Report","item":"https:\/\/www.serviceobjects.com\/docs\/dots-usage-report\/"},{"@type":"ListItem","position":3,"name":"UR &#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\/5411","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=5411"}],"version-history":[{"count":17,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/5411\/revisions"}],"predecessor-version":[{"id":11728,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/5411\/revisions\/11728"}],"up":[{"embeddable":true,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/5395"}],"wp:attachment":[{"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/media?parent=5411"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}