{"id":10847,"date":"2025-05-19T14:32:49","date_gmt":"2025-05-19T22:41:01","guid":{"rendered":"https:\/\/www.serviceobjects.com\/docs\/?page_id=10847"},"modified":"2026-03-02T09:47:34","modified_gmt":"2026-03-02T17:47:34","slug":"av3-getbestmatches-recommended","status":"publish","type":"page","link":"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-operations\/av3-getbestmatches-recommended\/","title":{"rendered":"AV3 &#8211; GetBestMatches &#8211; Recommended"},"content":{"rendered":"<nav aria-label=\"Table of contents\">\n<ul class=\"wp-block-list is-style-bullets-list\">\n<li><a href=\"#AV3-GetBestMatches-Recommended-URLEndpoints\">URL Endpoints<\/a><\/li>\n<li><a href=\"#AV3-GetBestMatches-Recommended-GetBestMatchesInputs\">GetBestMatches Inputs<\/a><\/li>\n<li><a href=\"#AV3-GetBestMatches-Recommended-GetBestMatchesOutputs\">GetBestMatches Outputs<\/a><\/li>\n<li><a href=\"#AV3-GetBestMatches-Recommended-Example\">Example Request URL and Response<\/a><\/li>\n<li><a href=\"#AV3-GetBestMatches-Recommended-References\">References<\/a><\/li>\n<\/ul>\n<\/nav>&nbsp;\n<article>Returns parsed and validated address elements including Delivery Point Validation (DPV), Residential Delivery Indicator (RDI), and Suite data. GetBestMatches will attempt to validate the input address against a CASS approved engine, and make corrections where possible. Multiple address candidates may be returned if a definitive decision cannot be made by the service.<\/article>\n<div class=\"wp-block-spacer\" style=\"height: 30px;\" aria-hidden=\"true\">\u00a0<\/div>\n<section aria-labelledby=\"AV3-GetBestMatches-Recommended-URLEndpoints\">\n<h2 id=\"AV3-GetBestMatches-Recommended-URLEndpoints\" class=\"wp-block-heading\">URL Endpoints<\/h2>\n<ul class=\"wp-block-list is-style-no-bullets-indented-list\">\n<li><strong>JSON<\/strong>\n<ul><li><a href=\"https:\/\/trial.serviceobjects.com\/AV3\/api.svc\/GetBestMatchesJson?BusinessName={BUSINESSNAME}&amp;Address={ADDRESS}&amp;Address2={ADDRESS2}&amp;City={CITY}&amp;State={STATE}&amp;PostalCode={POSTALCODE}&amp;LicenseKey={LICENSEKEY}\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/trial.serviceobjects.com\/AV3\/api.svc\/GetBestMatchesJson?BusinessName={BUSINESSNAME}&amp;Address={ADDRESS}&amp;Address2={ADDRESS2}&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><li><a href=\"https:\/\/trial.serviceobjects.com\/AV3\/api.svc\/GetBestMatches?BusinessName={BUSINESSNAME}&amp;Address={ADDRESS}&amp;Address2={ADDRESS2}&amp;City={CITY}&amp;State={STATE}&amp;PostalCode={POSTALCODE}&amp;LicenseKey={LICENSEKEY}\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/trial.serviceobjects.com\/AV3\/api.svc\/GetBestMatches?BusinessName={BUSINESSNAME}&amp;Address={ADDRESS}&amp;Address2={ADDRESS2}&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-2007c393-995d-451e-b260-61f0b1d4baff\" target=\"_blank\" rel=\"noopener\">\n<br>803 Chapala St<br>\nSanta Barbara, CA 93101\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=\"AV3-GetBestMatches-Recommended-GetBestMatchesInputs\">\n<h1 id=\"AV3-GetBestMatches-Recommended-GetBestMatchesInputs\" class=\"wp-block-heading\">GetBestMatches Inputs<\/h1>\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>BusinessName<\/td>\n<td>String<\/td>\n<td>Name of business associated with this address. Used to append Suite data.<\/td>\n<\/tr>\n<tr>\n<td>Address<\/td>\n<td>String<\/td>\n<td>Address line of the address to validate.<br \/>For example, &#8220;123 Main Street&#8221;.<\/td>\n<\/tr>\n<tr>\n<td>Address2<\/td>\n<td>String<\/td>\n<td>This line is for address information that does not contribute to DPV coding an address. For example &#8220;C\/O John Smith&#8221; does not help validate the address, but is still useful in delivery.<\/td>\n<\/tr>\n<tr>\n<td>City<\/td>\n<td>String<\/td>\n<td>The city of the address to validate.<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.<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=\"AV3-GetBestMatches-Recommended-GetBestMatchesOutputs\">\n<h1 id=\"AV3-GetBestMatches-Recommended-GetBestMatchesOutputs\" class=\"wp-block-heading\">GetBestMatches Outputs<\/h1>\n<p><em>BestMatchesResponse<\/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>Addresses<\/td>\n<td>Address[]<\/td>\n<td>Varies<\/td>\n<td>The corrected address candidates.<\/td>\n<\/tr>\n<tr>\n<td>IsCASS<\/td>\n<td>String<\/td>\n<td>&#8220;true&#8221; or &#8220;false&#8221;<\/td>\n<td>Indicates if the unaltered input address is CASS certified. See \u201cWhat is CASS?\u201d below for more information.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-errors\/\" target=\"_blank\" rel=\"noreferrer noopener\">Error<\/a><\/td>\n<td>Error<\/td>\n<td>Varies<\/td>\n<td>Error object indicating why the service could not return a result. See \u201cErrors\u201d below for more information.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<p><em>Address<\/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>The corrected address line 1.<\/td>\n<\/tr>\n<tr>\n<td>Address2<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>The corrected address line 2.<\/td>\n<\/tr>\n<tr>\n<td>City<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>The corrected city name.<\/td>\n<\/tr>\n<tr>\n<td>State<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>The corrected state name.<\/td>\n<\/tr>\n<tr>\n<td>Zip<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>The corrected zip code + 4.<\/td>\n<\/tr>\n<tr>\n<td>IsResidential<\/td>\n<td>String<\/td>\n<td>\u201ctrue\u201d or \u201cfalse\u201d<\/td>\n<td>Indicates if the address is for a residence.<\/td>\n<\/tr>\n<tr>\n<td id=\"AV3-GetBestMatches-Recommended-SingleCite_1_1\"><a href=\"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-dpv-codes-dpv-notes-and-corrections\/\" target=\"_blank\" rel=\"noreferrer noopener\">DPV<\/a> <a href=\"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-operations\/av3-getbestmatches-recommended\/#AV3-GetBestMatches-Recommended-CiteSummary_1\"><sup>[1]<\/sup><\/a><\/td>\n<td>String<\/td>\n<td>1-4<\/td>\n<td>Number that correlates to a DPV(Delivery Point Validation)\u00a0result.\u00a0An indicator displaying whether or not the address is recognized as deliverable by the USPS.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-dpv-codes-dpv-notes-and-corrections\/\" target=\"_blank\" rel=\"noreferrer noopener\">DPVDesc<\/a><\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>Explains DPV result.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-dpv-codes-dpv-notes-and-corrections\/\" target=\"_blank\" rel=\"noreferrer noopener\">DPVNotes<\/a><\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>Number that correlates to DPV notes description. Service Objects may add or change Note descriptions, but will never modify existing codes.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-dpv-codes-dpv-notes-and-corrections\/\" target=\"_blank\" rel=\"noreferrer noopener\">DPVNotesDesc<\/a><\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>Details about the DPV result. Service Objects may add or change Note descriptions, but will never modify existing codes.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-dpv-codes-dpv-notes-and-corrections\/\" target=\"_blank\" rel=\"noreferrer noopener\">Corrections<\/a><\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>Number that correlates to a Corrections Description. Service Objects may add or change Correction descriptions, but will never modify existing codes.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-dpv-codes-dpv-notes-and-corrections\/\" target=\"_blank\" rel=\"noreferrer noopener\">CorrectionsDesc<\/a><\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>Description of what was corrected in an address. Service Objects may add or change Correction descriptions, but will never modify existing codes.<\/td>\n<\/tr>\n<tr>\n<td id=\"AV3-GetBestMatches-Recommended-SingleCite_2_1\">BarcodeDigits <a href=\"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-operations\/av3-getbestmatches-recommended\/#AV3-GetBestMatches-Recommended-CiteSummary_2\"><sup>[2]<\/sup><\/a><\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td><!-- wp:group {\"className\":\"is-style-accordion-section\"} -->\n<div class=\"wp-block-group is-style-accordion-section\"><!-- wp:paragraph -->\n<p>The post office delivery barcode digits.<\/p>\n<!-- \/wp:paragraph -->\n\n<!-- wp:group -->\n<div class=\"wp-block-group\"><!-- wp:paragraph -->\n<p><strong>Barcode Example: 931011445011<\/strong><\/p>\n<!-- \/wp:paragraph -->\n\n<!-- wp:table -->\n<figure class=\"wp-block-table\"><table><thead><tr><th scope=\"col\">931011445<\/th><th scope=\"col\">01<\/th><th scope=\"col\">1<\/th><\/tr><tr><td>Zip+4<\/td><td>Deliver Point Code<\/td><td>Checksum Digit<\/td><\/tr><\/thead><\/table><\/figure>\n<!-- \/wp:table --><\/div>\n<!-- \/wp:group --><\/div>\n<!-- \/wp:group --><\/td>\n<\/tr>\n<tr>\n<td>CarrierRoute<\/td>\n<td>String<\/td>\n<td>4 chars<\/td>\n<td>4 chars: 1 for the route type, 3 for the route code. Identifies a group of addresses when prepended by 5-digit Zip.<\/td>\n<\/tr>\n<tr>\n<td>CongressCode<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>The congress code is the congressional district number.<\/td>\n<\/tr>\n<tr>\n<td>CountyCode<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>The county code of the given address.<\/td>\n<\/tr>\n<tr>\n<td>CountyName<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>The name of the county in which the given address lies.<\/td>\n<\/tr>\n<tr>\n<td>FragmentHouse<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td><!-- wp:group {\"className\":\"is-style-accordion-section\",\"layout\":{\"type\":\"constrained\"}} -->\n<div class=\"wp-block-group is-style-accordion-section\"><!-- wp:paragraph -->\n<p>The parsed house number of the given address.<\/p>\n<!-- \/wp:paragraph -->\n\n<!-- wp:group {\"layout\":{\"type\":\"constrained\"}} -->\n<div class=\"wp-block-group\"><!-- wp:paragraph -->\n<p><strong>123<\/strong>&nbsp;in&nbsp;<strong>123<\/strong>&nbsp;North Main St West Apt A<\/p>\n<!-- \/wp:paragraph --><\/div>\n<!-- \/wp:group --><\/div>\n<!-- \/wp:group --><\/td>\n<\/tr>\n<tr>\n<td>FragmentPreDir<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td><!-- wp:group {\"className\":\"is-style-accordion-section\"} -->\n<div class=\"wp-block-group is-style-accordion-section\"><!-- wp:paragraph -->\n<p>The parsed pre-directional of the address's street<\/p>\n<!-- \/wp:paragraph -->\n\n<!-- wp:group -->\n<div class=\"wp-block-group\"><!-- wp:paragraph -->\n<p><strong>North<\/strong> in 123 <strong>North<\/strong> Main St West Apt A<\/p>\n<!-- \/wp:paragraph --><\/div>\n<!-- \/wp:group --><\/div>\n<!-- \/wp:group --><\/td>\n<\/tr>\n<tr>\n<td>FragmentStreet<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td><!-- wp:group {\"className\":\"is-style-accordion-section\"} -->\n<div class=\"wp-block-group is-style-accordion-section\"><!-- wp:paragraph -->\n<p>The parsed name of the street in the given address<\/p>\n<!-- \/wp:paragraph -->\n\n<!-- wp:group -->\n<div class=\"wp-block-group\"><!-- wp:paragraph -->\n<p><strong>Main<\/strong> in 123 North <strong>Main<\/strong> St West Apt A<\/p>\n<!-- \/wp:paragraph --><\/div>\n<!-- \/wp:group --><\/div>\n<!-- \/wp:group --><\/td>\n<\/tr>\n<tr>\n<td>FragmentSuffix<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td><!-- wp:group {\"className\":\"is-style-accordion-section\"} -->\n<div class=\"wp-block-group is-style-accordion-section\"><!-- wp:paragraph -->\n<p>The parsed suffix of the street in the given address<\/p>\n<!-- \/wp:paragraph -->\n\n<!-- wp:group -->\n<div class=\"wp-block-group\"><!-- wp:paragraph -->\n<p><strong>St<\/strong> in 123 North Main <strong>St<\/strong> West Apt A<\/p>\n<!-- \/wp:paragraph --><\/div>\n<!-- \/wp:group --><\/div>\n<!-- \/wp:group --><\/td>\n<\/tr>\n<tr>\n<td>FragmentPostDir<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td><!-- wp:group {\"className\":\"is-style-accordion-section\"} -->\n<div class=\"wp-block-group is-style-accordion-section\"><!-- wp:paragraph -->\n<p>The parsed post-directional of the address's street<\/p>\n<!-- \/wp:paragraph -->\n\n<!-- wp:group -->\n<div class=\"wp-block-group\"><!-- wp:paragraph -->\n<p><strong>West<\/strong> in 123 North Main St <strong>West<\/strong> Apt A<\/p>\n<!-- \/wp:paragraph --><\/div>\n<!-- \/wp:group --><\/div>\n<!-- \/wp:group --><\/td>\n<\/tr>\n<tr>\n<td>FragmentUnit<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>The parsed unit type (e.g. &#8220;Apt&#8221; or &#8220;Ste&#8221;)<\/td>\n<\/tr>\n<tr>\n<td>Fragment<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td>The parsed &#8220;Fragment&#8221; box, apartment or unit number.<\/td>\n<\/tr>\n<tr>\n<td>FragmentPMBPrefix<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td><!-- wp:group {\"className\":\"is-style-accordion-section\"} -->\n<div class=\"wp-block-group is-style-accordion-section\"><!-- wp:paragraph -->\n<p>The parsed type of the apartment, box, unit, etc<\/p>\n<!-- \/wp:paragraph -->\n\n<!-- wp:group -->\n<div class=\"wp-block-group\"><!-- wp:paragraph -->\n<p><strong>Apt<\/strong> in 123 North Main St West <strong>Apt<\/strong> A<\/p>\n<!-- \/wp:paragraph --><\/div>\n<!-- \/wp:group --><\/div>\n<!-- \/wp:group --><\/td>\n<\/tr>\n<tr>\n<td>FragmentPMBNumber<\/td>\n<td>String<\/td>\n<td>Varies<\/td>\n<td><!-- wp:group {\"className\":\"is-style-accordion-section\"} -->\n<div class=\"wp-block-group is-style-accordion-section\"><!-- wp:paragraph -->\n<p>The parsed apartment, box, unit, etc. number of the given address.<\/p>\n<!-- \/wp:paragraph -->\n\n<!-- wp:group -->\n<div class=\"wp-block-group\"><!-- wp:paragraph -->\n<p><strong>123<\/strong>\u00a0in\u00a0<strong>123<\/strong>\u00a0North Main St West Apt A<\/p>\n<!-- \/wp:paragraph --><\/div>\n<!-- \/wp:group --><\/div>\n<!-- \/wp:group --><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<\/section>\n<aside class=\"wp-block-group is-style-accordion-section\">\n<div class=\"wp-block-group panel\">\u00a0<\/div>\n<\/aside>\n<section aria-labelledby=\"AV3-GetBestMatches-Recommended-Example\">\n<h1 id=\"AV3-GetBestMatches-Recommended-Example\" class=\"wp-block-heading\">Example Request URL and Response<\/h1>\n<article>To validate the address <strong>136 West Canon Perdido St Ste D Santa Barbara, CA 93101<\/strong>, the JSON request URL can be formatted with <strong>query string parameters<\/strong> as follows:<\/article>\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/trial.serviceobjects.com\/AV3\/api.svc\/GetBestMatchesJson?BusinessName=Service+Objects&amp;Address=136+W+Canon+Perdido+St%2C+Suite+D&amp;Address2=&amp;City=Santa+Barbara&amp;State=CA&amp;PostalCode=93101&amp;LicenseKey={LICENSEKEY}\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/trial.serviceobjects.com\/AV3\/api.svc\/GetBestMatchesJson?BusinessName=Service+Objects&amp;Address=136+W+Canon+Perdido+St%2C+Suite+D&amp;Address2=&amp;City=Santa+Barbara&amp;State=CA&amp;PostalCode=93101&amp;LicenseKey={LICENSEKEY}<\/a><\/li>\n<\/ul>\n<article>The corresponding JSON response is:<\/article>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"json\">{\n  \"Addresses\": [\n    {\n      \"Address1\": \"136 W Canon Perdido St STE D\",\n      \"Address2\": \"\",\n      \"City\": \"Santa Barbara\",\n      \"State\": \"CA\",\n      \"Zip\": \"93101-8207\",\n      \"IsResidential\": \"false\",\n      \"DPV\": \"1\",\n      \"DPVDesc\": \"Yes, the input record is a valid mailing address\",\n      \"DPVNotes\": \"24,26,28,39\",\n      \"DPVNotesDesc\": \"SuiteLink did not find Suite or Unit data to append to the address,The input address matched the ZIP+4 record,The input address matched the DPV record,Highrise apartment\/office building address\",\n      \"Corrections\": \"\",\n      \"CorrectionsDesc\": \"\",\n      \"BarcodeDigits\": \"931018207766\",\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\": \"STE\",\n      \"Fragment\": \"D\",\n      \"FragmentPMBPrefix\": \"\",\n      \"FragmentPMBNumber\": \"\"\n    }\n  ],\n  \"IsCASS\": true\n}\n<\/pre>\n<\/section>\n<section aria-labelledby=\"AV3-GetBestMatches-Recommended-References\">\n<h1 id=\"AV3-GetBestMatches-Recommended-References\" class=\"wp-block-heading\">References<\/h1>\n<ul id=\"AV3-GetBestMatches-Recommended-CiteSummary_1\" class=\"wp-block-list is-style-no-bullets-indented-list\">\n<li>1.<a href=\"#AV3-GetBestMatches-Recommended-SingleCite_1_1\">^ <\/a><br \/><a href=\"https:\/\/www.serviceobjects.com\/blog\/cass-dpv-higher-standard-address-accuracy\/\" target=\"_blank\" rel=\"noreferrer noopener\">CASS and DPV: A Higher Standard for Address Accuracy<\/a><\/li>\n<\/ul>\n<ul id=\"AV3-GetBestMatches-Recommended-CiteSummary_2\" class=\"wp-block-list is-style-no-bullets-indented-list\">\n<li>2.<a href=\"#AV3-GetBestMatches-Recommended-SingleCite_2_1\">^ <\/a><br \/><a href=\"https:\/\/www.serviceobjects.com\/blog\/address-deduplication-using-usps-barcodes\/\" target=\"_blank\" rel=\"noreferrer noopener\">Address Deduplication Using USPS Barcodes<\/a><\/li>\n<\/ul>\n<\/section>\n\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p>URL Endpoints GetBestMatches Inputs GetBestMatches Outputs Example Request URL and Response References &nbsp; Returns parsed and validated address elements including Delivery Point Validation (DPV), Residential Delivery Indicator (RDI), and Suite data. GetBestMatches will attempt to validate the input address against a CASS approved engine, and make corrections where possible. Multiple address candidates may be returned [&hellip;]<\/p>\n","protected":false},"author":21,"featured_media":0,"parent":10835,"menu_order":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-10847","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 - GetBestMatches - Recommended<\/title>\n<meta name=\"description\" content=\"URL Endpoints GetBestMatches Inputs GetBestMatches Outputs Example Request URL and Response References &nbsp; Returns parsed and validated address\" \/>\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-getbestmatches-recommended\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"AV3 - GetBestMatches - Recommended\" \/>\n<meta property=\"og:description\" content=\"URL Endpoints GetBestMatches Inputs GetBestMatches Outputs Example Request URL and Response References &nbsp; Returns parsed and validated address\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-operations\/av3-getbestmatches-recommended\/\" \/>\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:47:34+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=\"4 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-getbestmatches-recommended\/\",\"url\":\"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-operations\/av3-getbestmatches-recommended\/\",\"name\":\"AV3 - GetBestMatches - Recommended\",\"isPartOf\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#website\"},\"datePublished\":\"2025-05-19T22:41:01+00:00\",\"dateModified\":\"2026-03-02T17:47:34+00:00\",\"description\":\"URL Endpoints GetBestMatches Inputs GetBestMatches Outputs Example Request URL and Response References &nbsp; Returns parsed and validated address\",\"breadcrumb\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-operations\/av3-getbestmatches-recommended\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-operations\/av3-getbestmatches-recommended\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-operations\/av3-getbestmatches-recommended\/#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; GetBestMatches &#8211; Recommended\"}]},{\"@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 - GetBestMatches - Recommended","description":"URL Endpoints GetBestMatches Inputs GetBestMatches Outputs Example Request URL and Response References &nbsp; Returns parsed and validated address","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-getbestmatches-recommended\/","og_locale":"en_US","og_type":"article","og_title":"AV3 - GetBestMatches - Recommended","og_description":"URL Endpoints GetBestMatches Inputs GetBestMatches Outputs Example Request URL and Response References &nbsp; Returns parsed and validated address","og_url":"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-operations\/av3-getbestmatches-recommended\/","og_site_name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","article_modified_time":"2026-03-02T17:47:34+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-operations\/av3-getbestmatches-recommended\/","url":"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-operations\/av3-getbestmatches-recommended\/","name":"AV3 - GetBestMatches - Recommended","isPartOf":{"@id":"https:\/\/www.serviceobjects.com\/docs\/#website"},"datePublished":"2025-05-19T22:41:01+00:00","dateModified":"2026-03-02T17:47:34+00:00","description":"URL Endpoints GetBestMatches Inputs GetBestMatches Outputs Example Request URL and Response References &nbsp; Returns parsed and validated address","breadcrumb":{"@id":"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-operations\/av3-getbestmatches-recommended\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-operations\/av3-getbestmatches-recommended\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.serviceobjects.com\/docs\/dots-address-validation-us-3\/av3-operations\/av3-getbestmatches-recommended\/#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; GetBestMatches &#8211; Recommended"}]},{"@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\/10847","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=10847"}],"version-history":[{"count":19,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/10847\/revisions"}],"predecessor-version":[{"id":12567,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/10847\/revisions\/12567"}],"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=10847"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}