API Reference
The AddressZen API powers global address autocomplete, US address verification, and contact-data validation.
Authentication, rate limits, error handling, and versioning →
Address Lookup
Type-ahead address search runs in two steps. Suggest returns ranked candidates from a partial query as the user types. Retrieve fetches the full, structured address record once a candidate is selected.
Suggest an Address
Autocomplete that returns ranked partial-address matches for a search query.
Retrieve an Address
Fetch the structured, fully populated address record for a selected suggestion.
To skip the integration work, drop in the Address Lookup library: a hosted widget that handles input debouncing, suggestion rendering, keyboard navigation, and field population.
Address Verification
Confirm that a given US address actually exists, has been formatted correctly, and is deliverable.
Verify Address
Submit a candidate US address and receive a normalised, USPS-verified result with deliverability indicators.
Key Management
Inspect and manage API keys programmatically. Useful for client-side integrations that need to check key health or surface usage to end users.
Availability
Check whether a key is active and has the balance and quota to issue lookups right now.
Details
Retrieve a key's configuration: allowed URLs, daily caps, per-user limits.
Update Details
Adjust a key's allowed URLs, caps, and other settings without rotating it.
Usage Stats
Query historical lookup volume for a key, broken down by day or licensee.
Logs (CSV)
Download a per-lookup audit trail for billing reconciliation or analytics.
Data Services
Validate contact data alongside addresses to keep records clean at point of capture.