{"id":10846,"date":"2025-05-19T14:32:49","date_gmt":"2025-05-19T22:41:13","guid":{"rendered":"https:\/\/www.serviceobjects.com\/docs\/?page_id=10846"},"modified":"2026-03-02T09:49:55","modified_gmt":"2026-03-02T17:49:55","slug":"av3-getsecondarynumbers","status":"publish","type":"page","link":"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-operations\/av3-getsecondarynumbers\/","title":{"rendered":"AV3 &#8211; GetSecondaryNumbers"},"content":{"rendered":"<section aria-labelledby=\"getsecondarynumbers-title\"><nav>\n<ul class=\"is-style-bullets-list\">\n<li><a href=\"#AV3-GetSecondaryNumbers-URLEndpoints\">URL Endpoints<\/a><\/li>\n<li><a href=\"#AV3-GetSecondaryNumbers-GetSecondaryNumbersInputs\">Inputs<\/a><\/li>\n<li><a href=\"#AV3-GetSecondaryNumbers-GetSecondaryNumbersOutputs\">Outputs<\/a><\/li>\n<li><a href=\"#AV3-GetSecondaryNumbers-TypicalExampleWorkflow\">Typical Workflow<\/a><\/li>\n<li><a href=\"#AV3-GetSecondaryNumbers-References\">References<\/a><\/li>\n<\/ul>\n<\/nav>\n<p id=\"getsecondarynumbers-title\">Returns parsed and validated address elements along with a list of potential secondary numbers for a given input address. The operation can be used with <a href=\"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-operations\/av3-getbestmatches-recommended\/\">GetBestMatches<\/a> to find secondary numbers for addresses missing or containing incorrect unit information.<\/p>\n<section aria-labelledby=\"endpoints-heading\">\n<h2 id=\"AV3-GetSecondaryNumbers-URLEndpoints\">URL Endpoints<\/h2>\n<ul class=\"is-style-no-bullets-indented-list\">\n<li><strong>JSON<\/strong>\n<ul>\n<li><a href=\"https:\/\/trial.serviceobjects.com\/AV3\/api.svc\/GetSecondaryNumbersJson?Address={ADDRESS}&amp;City={CITY}&amp;State={STATE}&amp;PostalCode={POSTALCODE}&amp;LicenseKey={LICENSEKEY}\">https:\/\/trial.serviceobjects.com\/AV3\/api.svc\/GetSecondaryNumbersJson?Address={ADDRESS}&amp;City={CITY}&amp;State={STATE}&amp;PostalCode={POSTALCODE}&amp;LicenseKey={LICENSEKEY}<\/a><\/li>\n<\/ul>\n<\/li>\n<li><strong>XML<\/strong>\n<ul>\n<li><a href=\"https:\/\/trial.serviceobjects.com\/AV3\/api.svc\/GetSecondaryNumbers?Address={ADDRESS}&amp;City={CITY}&amp;State={STATE}&amp;PostalCode={POSTALCODE}&amp;LicenseKey={LICENSEKEY}\">https:\/\/trial.serviceobjects.com\/AV3\/api.svc\/GetSecondaryNumbers?Address={ADDRESS}&amp;City={CITY}&amp;State={STATE}&amp;PostalCode={POSTALCODE}&amp;LicenseKey={LICENSEKEY}<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/section>\n<div style=\"display:flex; gap:16px; flex-wrap:wrap; margin:24px 0;\">\n<div style=\"border: 1px solid #d1d5db; border-radius: 8px; padding: 16px; max-width: 320px; background: #f9fafb; flex: 1;\">\n<h3 style=\"margin-top: 0; margin-bottom: 8px; font-size: 1.2em;\">Run This Request in Postman<\/h3>\n<p style=\"margin: 0; line-height: 1.4;\">Test with this address:\n<a style=\"font-weight: bold; color: #2563eb; text-decoration: none;\" href=\"https:\/\/www.postman.com\/service-objects-api\/service-objects\/example\/41579131-8dd2879b-35d6-4afe-9216-1785c4064e43\" target=\"_blank\" rel=\"noopener\">\n<br>2119 De La Vina St<br>\nSanta Barbara, CA 93105\n<\/a><\/p>\n \n<\/div>\n<div style=\"border: 1px solid #d1d5db; border-radius: 8px; padding: 16px; max-width: 320px; background: #f9fafb; flex: 1;\">\n<h3 style=\"margin-top: 0; margin-bottom: 8px; font-size: 1.2em;\">Check out the Integration Code in GitHub<br><\/h3>\n<p style=\"margin: 0; line-height: 1.4;\"><a style=\"font-weight: bold; color: #2563eb; text-decoration: none;\" href=\"https:\/\/github.com\/ServiceObjects\/address-validation-us-3\" target=\"_blank\" rel=\"noopener\">\nGitHub\n<\/a><\/p>\n \n<\/div>\n<\/div>\n<section aria-labelledby=\"inputs-heading\">\n<section aria-labelledby=\"AV3-GetSecondaryNumbers-GetSecondaryNumbers\">\n<h1 id=\"AV3-GetSecondaryNumbers-GetSecondaryNumbers\" class=\"wp-block-heading\">Coding Resources<\/h1>\n<p><a href=\"https:\/\/github.com\/ServiceObjects\/address-validation-us-3\">GitHub<\/a><\/p>\n<div class=\"postman-run-button\" data-postman-action=\"collection\/fork\" data-postman-visibility=\"public\" data-postman-var-1=\"41579131-f6c7aa9f-f55c-4776-a2c1-cd9ab4eace3c\" data-postman-collection-url=\"entityId=41579131-f6c7aa9f-f55c-4776-a2c1-cd9ab4eace3c&amp;entityType=collection&amp;workspaceId=8157105f-8ad6-4a05-997d-b66c426bf2b9\">\u00a0<\/div>\n<p><script type=\"text\/javascript\">\n  (function (p,o,s,t,m,a,n) {\n    !p[s] && (p[s] = function () { (p[t] || (p[t] = [])).push(arguments); });\n    !o.getElementById(s+t) && o.getElementsByTagName(\"head\")[0].appendChild((\n      (n = o.createElement(\"script\")),\n      (n.id = s+t), (n.async = 1), (n.src = m), n\n    ));\n  }(window, document, \"_pm\", \"PostmanRunObject\", \"https:\/\/run.pstmn.io\/button.js\"));\n<\/script><\/p>\n<\/section>\n<h2>\u00a0<\/h2>\n<h2 id=\"AV3-GetSecondaryNumbers-GetSecondaryNumbersInputs\">GetSecondaryNumbers Inputs<\/h2>\n<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th>Name<\/th>\n<th>Type<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Address<\/td>\n<td>String<\/td>\n<td>Address line of the address to validate.\u00a0\u00a0<br \/>For example, &#8220;123 Main Street&#8221;.<\/td>\n<\/tr>\n<tr>\n<td>City<\/td>\n<td>String<\/td>\n<td>The city of the address to validate.\u00a0<br \/>For example, &#8220;New York&#8221;.\u00a0 The city isn&#8217;t required, but if one is not provided, the Zip code is required.<\/td>\n<\/tr>\n<tr>\n<td>State<\/td>\n<td>String<\/td>\n<td>The state of the address to validate.\u00a0 For example, &#8220;NY&#8221;.\u00a0 This does not need to be contracted, full state names will work as well.\u00a0 The state isn&#8217;t required, but if one is not provided, the Zip code is required.<\/td>\n<\/tr>\n<tr>\n<td>PostalCode<\/td>\n<td>String<\/td>\n<td>The zip code of the address to validate.\u00a0 A zip code isn&#8217;t required, but if one is not provided, the City and State are required.<\/td>\n<\/tr>\n<tr>\n<td>LicenseKey*<\/td>\n<td>String<\/td>\n<td>Your license key to use the service.\u00a0\u00a0<br \/>Sign up for a free trial key at\u00a0<a href=\"https:\/\/www.serviceobjects.com\/address-validation\/\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/www.serviceobjects.com\/address-validation\/<\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<\/section>\n<section aria-labelledby=\"outputs-heading\">\n<h2 id=\"AV3-GetSecondaryNumbers-GetSecondaryNumbersOutputs\">GetSecondaryNumbers Outputs<\/h2>\n<p><em>SecondaryNumbersResponse<\/em><\/p>\n<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th>Name<\/th>\n<th>Type<\/th>\n<th>Values<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Address1<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>Corrected address line 1.<\/td>\n<\/tr>\n<tr>\n<td>City<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>Corrected city name.<\/td>\n<\/tr>\n<tr>\n<td>State<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>Corrected state name.<\/td>\n<\/tr>\n<tr>\n<td>ZIP<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>Corrected zip + 4.<\/td>\n<\/tr>\n<tr>\n<td>TotalCount<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>Total number of secondary numbers found.<\/td>\n<\/tr>\n<tr>\n<td>SecondaryNumbers<\/td>\n<td>String[]<\/td>\n<td>Varies<\/td>\n<td>List of secondary numbers.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-errors\/\" target=\"_blank\" rel=\"noopener noreferrer\">Error<\/a><\/td>\n<td>Error<\/td>\n<td>Varies<\/td>\n<td>Object indicating service failure. See \u201cErrors\u201d.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<\/section>\n<section aria-labelledby=\"workflow-heading\">\n<h2 id=\"AV3-GetSecondaryNumbers-TypicalExampleWorkflow\">Typical Example Workflow<\/h2>\n<ol>\n<li>Validate address using <a href=\"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-operations\/av3-getbestmatches-recommended\/\">GetBestMatches<\/a>.<\/li>\n<li>If DPV 3 or 4 returned:<\/li>\n<\/ol>\n<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<tbody>\n<tr>\n<td>3<\/td>\n<td><strong>Apartment or box number invalid<\/strong>, but main address valid.<\/td>\n<\/tr>\n<tr>\n<td>4<\/td>\n<td>Valid mailing address, but <strong>missing unit number<\/strong>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<p>Then, use GetSecondaryNumbers to retrieve potential unit numbers.<\/p>\n<p>Example: input address <strong>missing unit info<\/strong> for an office building.<\/p>\n<figure class=\"wp-block-table is-style-regular\">\n<table>\n<thead>\n<tr>\n<th>Input field<\/th>\n<th>Value<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Address<\/td>\n<td>136 West Canon Perdido St<\/td>\n<\/tr>\n<tr>\n<td>City<\/td>\n<td>Santa Barbara<\/td>\n<\/tr>\n<tr>\n<td>State<\/td>\n<td>CA<\/td>\n<\/tr>\n<tr>\n<td>PostalCode<\/td>\n<td>93101<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<p><strong>Example workflow in Python<\/strong><\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"python\">import requests\n\nAPI_KEY = 'YOUR_API_KEY_HERE'\n\n# Step 1: Call GetBestMatches\ndef get_best_matches(address, city, state, zip_code):\n    url = 'https:\/\/trial.serviceobjects.com\/av3\/api.svc\/GetBestMatchesJson'\n    params = {\n        'Address': address,\n        'City': city,\n        'State': state,\n        'PostalCode': zip_code,\n        'LicenseKey': API_KEY\n    }\n    response = requests.get(url, params=params)\n    return response.json()\n\n# Step 2: Call GetSecondaryNumbers\ndef get_secondary_numbers(address, city, state, zip_code):\n    url = 'https:\/\/trial.serviceobjects.com\/av3\/api.svc\/GetSecondaryNumbersJson'\n    params = {\n        'Address': address,\n        'City': city,\n        'State': state,\n        'PostalCode': zip_code,\n        'LicenseKey': API_KEY\n    }\n    response = requests.get(url, params=params)\n    return response.json()\n\n# Input address\naddress = \"136 West Canon Perdido St\"\ncity = \"Santa Barbara\"\nstate = \"CA\"\nzip_code = \"93101\"\n\n# Step 1: Validate the address\nbest_match_result = get_best_matches(address, city, state, zip_code)\n\n# Extract DPV code\ntry:\n    match = best_match_result['BestMatches'][0]\n    dpv_code = match['DPV']\n    print(f\"DPV Code: {dpv_code}\")\n    \n    # Step 2: If DPV indicates missing (4) or incorrect (3) secondary number\n    if dpv_code in ['3', '4']:\n        print(\"Secondary number is missing or incorrect. Fetching possible secondary numbers...\")\n        secondary_numbers_result = get_secondary_numbers(address, city, state, zip_code)\n        print(\"Possible secondary numbers:\")\n        for sec in secondary_numbers_result.get('SecondaryNumbers', []):\n            print(f\" - {sec}\")\n    else:\n        print(\"Address is complete and valid.\")\nexcept (KeyError, IndexError) as e:\n    print(\"Error parsing response:\", e)\n\n    <\/pre>\n<p><strong>GetBestMatches JSON Response &#8211; DPV 4<\/strong><\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\">{\n  \"Addresses\": [\n    {\n      \"Address1\": \"136 W Canon Perdido St\",\n      \"Address2\": \"\",\n      \"City\": \"Santa Barbara\",\n      \"State\": \"CA\",\n      \"Zip\": \"93101-3242\",\n      \"IsResidential\": \"false\",\n      \"DPV\": \"4\",\n      \"DPVDesc\": \"The input record is a valid mailing address, but is missing the apartment or rural route box number\",\n      \"DPVNotes\": \"11,22,24,26,39\",\n      \"DPVNotesDesc\": \"Default ZIP+4 record used to certify the address,Address exists but mail is being returned,SuiteLink did not find Suite or Unit data to append to the address,The input address matched the ZIP+4 record,Highrise apartment\/office building address\",\n      \"Corrections\": \"\",\n      \"CorrectionsDesc\": \"\",\n      \"BarcodeDigits\": \"931013242997\",\n      \"CarrierRoute\": \"C008\",\n      \"CongressCode\": \"24\",\n      \"CountyCode\": \"083\",\n      \"CountyName\": \"Santa Barbara\",\n      \"FragmentHouse\": \"136\",\n      \"FragmentPreDir\": \"W\",\n      \"FragmentStreet\": \"Canon Perdido\",\n      \"FragmentSuffix\": \"St\",\n      \"FragmentPostDir\": \"\",\n      \"FragmentUnit\": \"\",\n      \"Fragment\": \"\",\n      \"FragmentPMBPrefix\": \"\",\n      \"FragmentPMBNumber\": \"\"\n    }\n  ],\n  \"IsCASS\": true\n}\n    <\/pre>\n<p><strong>GetSecondaryNumbers &#8211; 8 different suite options found<\/strong><\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\">{\n  \"Address1\": \"136 W Canon Perdido St\",\n  \"City\": \"Santa Barbara\",\n  \"State\": \"CA\",\n  \"Zip\": \"93101\",\n  \"SecondaryNumbers\": [\n    \"STE A\",\n    \"STE B\",\n    \"STE C\",\n    \"STE D\",\n    \"STE E\",\n    \"STE B1\",\n    \"STE B2\",\n    \"STE D2\"\n  ],\n  \"TotalCount\": 8\n}\n    <\/pre>\n<\/section>\n<section aria-labelledby=\"references-heading\">\n<h2 id=\"AV3-GetSecondaryNumbers-References\">References<\/h2>\n<\/section>\n<\/section>\n\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p>URL Endpoints Inputs Outputs Typical Workflow References Returns parsed and validated address elements along with a list of potential secondary numbers for a given input address. The operation can be used with GetBestMatches to find secondary numbers for addresses missing or containing incorrect unit information. URL Endpoints JSON https:\/\/trial.serviceobjects.com\/AV3\/api.svc\/GetSecondaryNumbersJson?Address={ADDRESS}&amp;City={CITY}&amp;State={STATE}&amp;PostalCode={POSTALCODE}&amp;LicenseKey={LICENSEKEY} XML https:\/\/trial.serviceobjects.com\/AV3\/api.svc\/GetSecondaryNumbers?Address={ADDRESS}&amp;City={CITY}&amp;State={STATE}&amp;PostalCode={POSTALCODE}&amp;LicenseKey={LICENSEKEY} Run This Request in [&hellip;]<\/p>\n","protected":false},"author":21,"featured_media":0,"parent":10835,"menu_order":1,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-10846","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>AV3 - GetSecondaryNumbers<\/title>\n<meta name=\"description\" content=\"URL Endpoints Inputs Outputs Typical Workflow References Returns parsed and validated address elements along with a list of potential secondary numbers\" \/>\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-address-validation-us-3\/av3-operations\/av3-getsecondarynumbers\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"AV3 - GetSecondaryNumbers\" \/>\n<meta property=\"og:description\" content=\"URL Endpoints Inputs Outputs Typical Workflow References Returns parsed and validated address elements along with a list of potential secondary numbers\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-operations\/av3-getsecondarynumbers\/\" \/>\n<meta property=\"og:site_name\" content=\"Service Objects | Contact, Phone, Email Verification | Data Quality Services\" \/>\n<meta property=\"article:modified_time\" content=\"2026-03-02T17:49:55+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-address-validation-us-3\/av3-operations\/av3-getsecondarynumbers\/\",\"url\":\"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-operations\/av3-getsecondarynumbers\/\",\"name\":\"AV3 - GetSecondaryNumbers\",\"isPartOf\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#website\"},\"datePublished\":\"2025-05-19T22:41:13+00:00\",\"dateModified\":\"2026-03-02T17:49:55+00:00\",\"description\":\"URL Endpoints Inputs Outputs Typical Workflow References Returns parsed and validated address elements along with a list of potential secondary numbers\",\"breadcrumb\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-operations\/av3-getsecondarynumbers\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-operations\/av3-getsecondarynumbers\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-operations\/av3-getsecondarynumbers\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.serviceobjects.com\/docs\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"DOTS Address Validation &#8211; US 3\",\"item\":\"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"AV3 &#8211; Operations\",\"item\":\"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-operations\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"AV3 &#8211; GetSecondaryNumbers\"}]},{\"@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":"AV3 - GetSecondaryNumbers","description":"URL Endpoints Inputs Outputs Typical Workflow References Returns parsed and validated address elements along with a list of potential secondary numbers","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-address-validation-us-3\/av3-operations\/av3-getsecondarynumbers\/","og_locale":"en_US","og_type":"article","og_title":"AV3 - GetSecondaryNumbers","og_description":"URL Endpoints Inputs Outputs Typical Workflow References Returns parsed and validated address elements along with a list of potential secondary numbers","og_url":"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-operations\/av3-getsecondarynumbers\/","og_site_name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","article_modified_time":"2026-03-02T17:49:55+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-address-validation-us-3\/av3-operations\/av3-getsecondarynumbers\/","url":"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-operations\/av3-getsecondarynumbers\/","name":"AV3 - GetSecondaryNumbers","isPartOf":{"@id":"https:\/\/www.serviceobjects.com\/docs\/#website"},"datePublished":"2025-05-19T22:41:13+00:00","dateModified":"2026-03-02T17:49:55+00:00","description":"URL Endpoints Inputs Outputs Typical Workflow References Returns parsed and validated address elements along with a list of potential secondary numbers","breadcrumb":{"@id":"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-operations\/av3-getsecondarynumbers\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-operations\/av3-getsecondarynumbers\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-operations\/av3-getsecondarynumbers\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.serviceobjects.com\/docs\/"},{"@type":"ListItem","position":2,"name":"DOTS Address Validation &#8211; US 3","item":"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/"},{"@type":"ListItem","position":3,"name":"AV3 &#8211; Operations","item":"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-operations\/"},{"@type":"ListItem","position":4,"name":"AV3 &#8211; GetSecondaryNumbers"}]},{"@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\/10846","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\/21"}],"replies":[{"embeddable":true,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/comments?post=10846"}],"version-history":[{"count":27,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/10846\/revisions"}],"predecessor-version":[{"id":12570,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/10846\/revisions\/12570"}],"up":[{"embeddable":true,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/10835"}],"wp:attachment":[{"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/media?parent=10846"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}