{"id":1787,"date":"2022-11-07T23:52:34","date_gmt":"2022-11-07T23:52:34","guid":{"rendered":"https:\/\/serviceobjects.wpaladdin.com\/?post_type=serviceobjects&#038;p=1787"},"modified":"2022-12-14T22:08:23","modified_gmt":"2022-12-14T22:08:23","slug":"agi-errors","status":"publish","type":"page","link":"https:\/\/test.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-errors\/","title":{"rendered":"AGI &#8211; Errors"},"content":{"rendered":"\n<ul class=\"is-style-bullets-list wp-block-list\">\n<li><a href=\"https:\/\/test.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-errors\/#AGI-Errors-ErrorTypes\">Error Types<\/a>\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/test.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-errors\/#AGI-Errors-Errortype1:Authorization\">Error type 1: Authorization<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/test.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-errors\/#AGI-Errors-Errortype2:UserInput\">Error type 2: User Input<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/test.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-errors\/#AGI-Errors-Errortype3:ServiceObjectsFatal\">Error type 3: Service Objects Fatal<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<div style=\"height:30px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>Anything that happens during a run of DOTS Address Geocode International (AGI) that causes it to be unable to finish its normal processing is an error. If an error occurs, something similar to the following will result instead of the normal\/typical output:&nbsp;<\/p>\n\n\n\n<p><strong>Example:<\/strong><\/p>\n\n\n\n<div style=\"height:30px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<figure class=\"wp-block-table is-style-regular\"><table><tbody><tr><td><\/td><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;Please provide a valid license key for this web service.&lt;\/Desc&gt;<br>&nbsp; &lt;DescCode&gt;8&lt;\/DescCode&gt;<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"has-text-align-left is-style-no-bullets-list\">There are three error types described below.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"AGI-Errors-ErrorTypes\">Error Types<\/h2>\n\n\n\n<div style=\"height:30px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\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>No<\/td><td>No<\/td><\/tr><tr><td>Service Objects Fatal<\/td><td>3<\/td><td>No<\/td><td>Yes<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"AGI-Errors-Errortype1:Authorization\">Error type 1: Authorization<\/h2>\n\n\n\n<div style=\"height:30px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<ul class=\"is-style-no-bullets-indented-list wp-block-list\">\n<li>Theses are standard to all Generation 2 DOTS Web Services.<\/li>\n<\/ul>\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>0<\/td><td>Unknown authorization error.<\/td><\/tr><tr><td>1<\/td><td>Please provide a valid license key for this web service.<\/td><\/tr><tr><td>2<\/td><td>The daily allowable number of transactions for this license key has been exceeded.<\/td><\/tr><tr><td>3<\/td><td>The monthly allowable number of transactions for this license key has been exceeded.<\/td><\/tr><tr><td>4<\/td><td>The total allowable number of transactions for this license key has been exceeded.<\/td><\/tr><tr><td>5<\/td><td>There are not enough transactions available. Check your daily\/monthly transaction limits.<\/td><\/tr><tr><td>6<\/td><td>This license key has not yet been activated.<\/td><\/tr><tr><td>7<\/td><td>This license key has expired.<\/td><\/tr><tr><td>8<\/td><td>Your license key does not work on this service<\/td><\/tr><tr><td>13<\/td><td>This country is limited to specific usage. Please contact customer service to have your key enabled.<\/td><\/tr><tr><td>14<\/td><td>This output language is limited to specific usage.&nbsp; Please contact customer service to have your key enabled.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"AGI-Errors-Errortype2:UserInput\">Error type 2: User Input<\/h2>\n\n\n\n<div style=\"height:30px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<ul class=\"is-style-no-bullets-indented-list wp-block-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\n\n\n<figure class=\"wp-block-table is-style-regular\"><table><thead><tr><th>DescCode<\/th><th>Desc<\/th><th>Additional Details<\/th><\/tr><\/thead><tbody><tr><td>1<\/td><td>You must input a license key in the LicenseKey field.<\/td><td><\/td><\/tr><tr><td>2<\/td><td>You must input a place or address to search for.<\/td><td><\/td><\/tr><tr><td>4<\/td><td>Please input a valid Search Type.<\/td><td><\/td><\/tr><tr><td>5<\/td><td>SingleLine input detected. Use of the parsed address input parameters, Address1-5, Locality, AdministrativeArea and PostalCode are not allowed when SingleLine is provided.<\/td><td>The service does not allow you to mix a single line address input with parsed address inputs.<br>You must choose either a single line address input or a parsed address input. Not both.<\/td><\/tr><tr><td>8<\/td><td>The length of one or more Address field input values is too long.<\/td><td>Inputs Address1-5 are not to exceed 300 characters in length each.<\/td><\/tr><tr><td>9<\/td><td>The length of the Locality field input value is too long.<\/td><td>The Locality input is not to exceed 300 characters in length.<\/td><\/tr><tr><td>10<\/td><td>The length of the AdministrativeArea field input value is too long.<\/td><td>The&nbsp;AdministrativeArea&nbsp;input is not to exceed 300 characters in length.<\/td><\/tr><tr><td>11<\/td><td>The length of the PostalCode field input value is too long.<\/td><td>The&nbsp;PostalCode&nbsp;input is not to exceed 50 characters in length.<\/td><\/tr><tr><td>12<\/td><td>The length of the Country field input value is too long.<\/td><td>The&nbsp;Country&nbsp;input is not to exceed 300 characters in length.<\/td><\/tr><tr><td>13<\/td><td>You must input a country.<\/td><td><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"AGI-Errors-Errortype3:ServiceObjectsFatal\">Error type 3: Service Objects Fatal<\/h2>\n\n\n\n<div style=\"height:30px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<ul class=\"is-style-no-bullets-indented-list wp-block-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 a bug in the DOTS Address Validation International service, or a Network\/Connectivity issue.<\/li>\n<\/ul>\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>Unhandled error. Please contact Service Objects.<\/td><\/tr><\/tbody><\/table><\/figure>\n","protected":false},"excerpt":{"rendered":"<p>Anything that happens during a run of DOTS Address Geocode International (AGI) that causes it to be unable to finish its normal processing is an error. If an error occurs, something similar to the following will result instead of the normal\/typical output:&nbsp; Example: *Error!*&nbsp; &lt;Type&gt;Authorization&lt;\/Type&gt;&nbsp; &lt;TypeCode&gt;1&lt;\/TypeCode&gt;&nbsp; &lt;Desc&gt;Please provide a valid license key for this web [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":1677,"menu_order":1,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-1787","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>AGI - Errors<\/title>\n<meta name=\"description\" content=\"Error Types Error type 1: Authorization Error type 2: User Input Error type 3: Service Objects Fatal Anything that happens during a run of DOTS Address\" \/>\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=\"AGI - Errors\" \/>\n<meta property=\"og:description\" content=\"Error Types Error type 1: Authorization Error type 2: User Input Error type 3: Service Objects Fatal Anything that happens during a run of DOTS Address\" \/>\n<meta property=\"og:url\" content=\"https:\/\/test.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-errors\/\" \/>\n<meta property=\"og:site_name\" content=\"Service Objects | Contact, Phone, Email Verification | Data Quality Services\" \/>\n<meta property=\"article:modified_time\" content=\"2022-12-14T22:08:23+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:\/\/test.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-errors\/\",\"url\":\"https:\/\/test.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-errors\/\",\"name\":\"AGI - Errors\",\"isPartOf\":{\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/#website\"},\"datePublished\":\"2022-11-07T23:52:34+00:00\",\"dateModified\":\"2022-12-14T22:08:23+00:00\",\"description\":\"Error Types Error type 1: Authorization Error type 2: User Input Error type 3: Service Objects Fatal Anything that happens during a run of DOTS Address\",\"breadcrumb\":{\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-errors\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/test.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-errors\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/test.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-errors\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/test.serviceobjects.com\/docs\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"DOTS Address Geocode &#8211; International\",\"item\":\"https:\/\/test.serviceobjects.com\/docs\/dots-address-geocode-international\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"AGI &#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":"AGI - Errors","description":"Error Types Error type 1: Authorization Error type 2: User Input Error type 3: Service Objects Fatal Anything that happens during a run of DOTS Address","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":"AGI - Errors","og_description":"Error Types Error type 1: Authorization Error type 2: User Input Error type 3: Service Objects Fatal Anything that happens during a run of DOTS Address","og_url":"https:\/\/test.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-errors\/","og_site_name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","article_modified_time":"2022-12-14T22:08:23+00:00","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-address-geocode-international\/agi-errors\/","url":"https:\/\/test.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-errors\/","name":"AGI - Errors","isPartOf":{"@id":"https:\/\/test.serviceobjects.com\/docs\/#website"},"datePublished":"2022-11-07T23:52:34+00:00","dateModified":"2022-12-14T22:08:23+00:00","description":"Error Types Error type 1: Authorization Error type 2: User Input Error type 3: Service Objects Fatal Anything that happens during a run of DOTS Address","breadcrumb":{"@id":"https:\/\/test.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-errors\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/test.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-errors\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/test.serviceobjects.com\/docs\/dots-address-geocode-international\/agi-errors\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/test.serviceobjects.com\/docs\/"},{"@type":"ListItem","position":2,"name":"DOTS Address Geocode &#8211; International","item":"https:\/\/test.serviceobjects.com\/docs\/dots-address-geocode-international\/"},{"@type":"ListItem","position":3,"name":"AGI &#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\/1787","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\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/comments?post=1787"}],"version-history":[{"count":12,"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/1787\/revisions"}],"predecessor-version":[{"id":7269,"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/1787\/revisions\/7269"}],"up":[{"embeddable":true,"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/1677"}],"wp:attachment":[{"href":"https:\/\/test.serviceobjects.com\/docs\/wp-json\/wp\/v2\/media?parent=1787"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}