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.