Address Validation API
A complete REST API for address validation, normalization, geocoding, and autocomplete. Designed for developers who need reliable, explainable address data.
Available Endpoints
All endpoints accept JSON requests and return JSON responses. Authentication is via Bearer token.
Base URL: https://api.addrex.io · Docs: https://docs.addrex.dev · Console: console.addrex.io (coming soon)
| Method | Endpoint | Description |
|---|---|---|
| POST | /v1/validate | Validate and standardize a single address with geocoding. |
| POST | /v1/normalize | Parse and standardize an address without validation. |
| POST | /v1/geocode | Get coordinates for a validated address. |
| GET | /v1/autocomplete | Get address suggestions as the user types. |
| POST | /v1/reverse | Convert coordinates to a street address. |
| POST | /v1/addresses/extract | Extract and validate multiple addresses from free-form text. |
Validate & Geocode
The primary endpoint for address validation. Accepts a raw address, validates it against our national reference dataset, standardizes the format, and optionally returns geocoding data.
Input Fields
line1- Street address (required)line2- Unit, suite, apt (optional)city- City name (required)state- State code (required)zip- ZIP code (optional but recommended)
Response Fields
status- VALIDATED, NOT_IN_REFERENCE, or INVALIDconfidence- Match confidence score (0-1)match_code- EXACT, PARTIAL, or NO_MATCHreason_codes- Array of change/issue codes
curl -X POST https://api.addrex.io/v1/validate \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"address": {
"line1": "123 Main St",
"line2": "Apt 4B",
"city": "New York",
"state": "NY",
"zip": "10001"
},
"options": {
"geocode": true,
"include_reason_codes": true
}
}'{
"id": "req_abc123",
"status": "VALIDATED",
"confidence": 0.95,
"input": {
"line1": "123 Main St",
"line2": "Apt 4B",
"city": "New York",
"state": "NY",
"zip": "10001"
},
"standardized": {
"line1": "123 Main St",
"line2": "Apt 4B",
"city": "New York",
"state": "NY",
"zip5": "10001",
"zip4": "1234"
},
"geocode": {
"lat": 40.7484,
"lon": -73.9967,
"quality": "ROOFTOP",
"accuracy_meters": 5
},
"match_code": "EXACT",
"reason_codes": [],
"changes": ["ZIP4_ADDED"]
}Autocomplete
Provide type-ahead address suggestions as users type. Reduces form friction and improves data quality at the point of entry.
Query Parameters
query- Partial address string (required)limit- Max suggestions to return (default: 5)state- Filter by state (optional)
Note
Autocomplete requests are billed separately from validation requests. See our pricing page for details.
curl -G https://api.addrex.io/v1/autocomplete \
-H "Authorization: Bearer YOUR_API_KEY" \
--data-urlencode "query=123 main" \
--data-urlencode "limit=5"{
"suggestions": [
{
"text": "123 Main St, New York, NY 10001",
"highlight": "123 Main",
"place_id": "pl_xyz789"
},
{
"text": "123 Main Ave, Brooklyn, NY 11201",
"highlight": "123 Main",
"place_id": "pl_abc456"
}
]
}SDKs Coming Soon
We're building official SDKs for JavaScript, Python, Ruby, Go, and PHP. In the meantime, our REST API works with any HTTP client.
Want early access? Let us know.