# API Reference

The AddressZen API powers global address autocomplete, US address verification, and contact-data validation.

[Authentication, rate limits, error handling, and versioning →](/docs/api/api-reference.md)

## Address Lookup[​](#address-lookup "Direct link to 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.

[](/docs/api/find-address.md)

### [Suggest an Address](/docs/api/find-address.md)[​](#suggest-an-address "Direct link to Suggest an Address")

Autocomplete that returns ranked partial-address matches for a search query.

[](/docs/api/retrieve-address.md)

### [Retrieve an Address](/docs/api/retrieve-address.md)[​](#retrieve-an-address "Direct link to 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](/docs/address-lookup.md): a hosted widget that handles input debouncing, suggestion rendering, keyboard navigation, and field population.

## Address Verification[​](#address-verification "Direct link to Address Verification")

Confirm that a given US address actually exists, has been formatted correctly, and is deliverable.

[](/docs/api/address-verify.md)

### [Verify Address](/docs/api/address-verify.md)[​](#verify-address "Direct link to Verify Address")

Submit a candidate US address and receive a normalised, USPS-verified result with deliverability indicators.

## Key Management[​](#key-management "Direct link to 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.

[](/docs/api/key-availability.md)

### [Availability](/docs/api/key-availability.md)[​](#availability "Direct link to Availability")

Check whether a key is active and has the balance and quota to issue lookups right now.

[](/docs/api/key-details.md)

### [Details](/docs/api/key-details.md)[​](#details "Direct link to Details")

Retrieve a key's configuration: allowed URLs, daily caps, per-user limits.

[](/docs/api/update-key-details.md)

### [Update Details](/docs/api/update-key-details.md)[​](#update-details "Direct link to Update Details")

Adjust a key's allowed URLs, caps, and other settings without rotating it.

[](/docs/api/key-usage.md)

### [Usage Stats](/docs/api/key-usage.md)[​](#usage-stats "Direct link to Usage Stats")

Query historical lookup volume for a key, broken down by day or licensee.

[](/docs/api/key-logs.md)

### [Logs (CSV)](/docs/api/key-logs.md)[​](#logs-csv "Direct link to Logs (CSV)")

Download a per-lookup audit trail for billing reconciliation or analytics.

## Data Services[​](#data-services "Direct link to Data Services")

Validate contact data alongside addresses to keep records clean at point of capture.

[](/docs/api/phone-number-validation.md)

### [Phone Number Validation](/docs/api/phone-number-validation.md)[​](#phone-number-validation "Direct link to Phone Number Validation")

Verify that a phone number is well-formed and active, with line-type and country metadata.

[](/docs/api/email-validation.md)

### [Email Validation](/docs/api/email-validation.md)[​](#email-validation "Direct link to Email Validation")

Check syntax, MX records, and deliverability for an email address.