Address and Phone Number Validation for API Order Placement

When placing orders through our API, we validate both addresses and phone numbers to ensure data accuracy. Here's what you need to know about our validation requirements:

Address Validation

We use Google Address Validation to verify addresses. You can test address formats using Google's demo environment at https://developers.google.com/maps/documentation/address-validation/demo.

Troubleshooting Invalid Addresses

If an address is returned as invalid (for example, when the Google response includes "validationGranularity": "OTHER"), here are a few steps you can take to investigate:

1. Check with Google Address Validation

   Start by entering the address into Google’s Address Validation demo to see the detailed response. Pay attention to the validationGranularity and any suggested corrections.

2. Verify with USPS

   Use the USPS Zip Code Lookup tool to confirm that the address exists and is correctly formatted. If USPS returns results with missing or partial fields, that can indicate an invalid or incomplete address.

3. Search on Google Maps

   Enter the address into Google Maps to see if it matches an actual location. If no single result is returned, look for similar addresses nearby that might have the same street name or unit number.

   For example, if only one address appears on that street, it may mean the street number or unit number was entered incorrectly.

4. Test a corrected version

   If you suspect an error (such as the wrong street number or a missing unit), try the corrected version in both the Google Address Validation demo and USPS Lookup tool to see if it validates successfully.

5. Use an alternative address validator (optional)

   If you still can’t confirm the address, try checking it with Smarty Address Verification. This can sometimes provide more granular feedback than Google or USPS.

6. Confirm with the patient or user

   If validation continues to fail, reach out to confirm the address details directly. In many cases, minor typos or swapped fields (like street number vs. unit number) are the cause.

Phone Number Validation

We use Twilio v1 Lookup API for phone number validation. You can find more details about this service at https://www.twilio.com/docs/lookup/v1-api.

Supported regions: We currently only support US phone numbers.

Recommended format: While our system can parse various formats and punctuation, we recommend sending phone numbers in the format +1XXXXXXXXXX for best results.