Skip to content
POST AI agent ready /v1/address/validate

Address Validation API - Free Address Verification

Send a freeform address string and get back structured components (house number, road, city, state, postal code, country), GPS coordinates, a confidence score, and the formatted address. Uses geocoding to verify the address exists and is parseable. Returns 404 if no match is found.

Parameters

stringrequired

Freeform address to validate.

Code examples

curl -X POST https://api.botoi.com/v1/address/validate \
  -H "Content-Type: application/json" \
  -d '{"address":"1600 Amphitheatre Parkway, Mountain View, CA"}'

When to use this API

Validate shipping addresses at checkout

Verify customer-entered shipping addresses before processing orders. Catch typos, incomplete addresses, and non-existent locations before they reach your fulfillment team. Reduces failed deliveries and return-to-sender costs.

Standardize address formats across systems

Normalize addresses from CRM imports, CSV uploads, and form submissions into a consistent structured format. Ensures your database has clean, geocoded address records for analytics and logistics.

Pre-fill form fields from partial address input

Use the structured components from validation to auto-fill city, state, and postal code fields after a user enters a street address. Reduces form abandonment and data entry errors.

Frequently asked questions

How accurate is the address validation?
The endpoint uses OpenStreetMap geocoding data. It is strong for well-known addresses in North America and Europe. Rural or newly built addresses may have lower confidence scores or return no results.
What does the confidence score mean?
The confidence score (0 to 1) reflects how well the input matches the geocoding result. Scores above 0.7 indicate a strong match. Scores below 0.4 suggest the address may be ambiguous or partially matched.
Does this verify the address exists as a real mailing address?
No. This endpoint geocodes the address and returns structured data. It confirms the location is recognized by mapping databases, not that mail can be delivered there. For USPS delivery verification, you need a postal service API.
Can I validate international addresses?
Yes. The geocoding service covers addresses worldwide. The country_code field in the response tells you which country the address resolved to.
What happens if the address is too vague?
Vague inputs like "Main Street" may return a result with low confidence or match the wrong location. Include city, state, or country for better results.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.