Why are business_name_match, business_address_match, or the scores returning null?
Last updated: July 9, 2026
There are two primary reasons a search fails, and in both cases the comparison fields come back null:
The input address wasn't a valid USPS address. The response's error field will read: "Failed to normalize address."
We couldn't find a matching Secretary of State registration for the business. The response's error field will read: "No match found."
In either case the search is marked FAILED, and fields like business_name_match and business_address_match are null because there was no matched business to compare against.