Skip to main content
Address Verify validates and cleanses address data against reference datasets, correcting errors and standardizing formats to ensure accurate deliveries.

​
Coverage

  • Global: Address verification for 250+ countries and territories
  • Certified datasets: Includes CASS (US) and PAF (UK) certified postal data
  • Geocoding: Latitude/longitude coordinates and reverse geocoding capabilities
  • Transliteration: International address conversion for cross-border operations

​
Available Endpoints

Address Verify provides one primary API endpoint:

​
Getting Started

  1. Create an API key if you don’t have one
  2. Structure your address data using the input fields that match your data format
  3. Make your first request using the endpoint documentation above
Here’s an example request for the International Batch Cleanse endpoint:

​
What Address Verify Returns

Address Verify provides:
  • Verified and standardized address in multiple formats (mailing format, delivery format, structured components)
  • Address Verification Code (AVC) indicating verification level and match quality
  • Address Quality Index (AQI) for simplified quality assessment
  • Geocoding data (latitude/longitude) when available
  • Corrected postal codes and administrative areas
Response should be in the following format:
And you can use this information below to interpret the response fields:

​
Geocoding Data

​
Formatted Address Output

​
Address Components

​
Organization and Contact

​
Country Information

​
Verification Indicators

​
Address Formatting (Optional)

Understanding the AVC:
  • Verification Status (1st character): V=Verified, P=Partially verified, A=Ambiguous, R=Reverted, U=Unverified
  • Match Level (2nd-3rd characters): 0=None through 5=Delivery point (higher is more granular)
  • Parsing Quality (middle section): How well the input was parsed
  • Matchscore (final number): Percentage match between input and reference (100=perfect match, no changes needed)
Note: This quickstart covers the most commonly used fields. Address Verify returns many additional country-specific and certification-specific fields (CASS, PAF, etc.). See the full API documentation for complete field reference.
Address Verify accepts multiple input formats. Use the fields that match your data structure:

​
Unstructured Input

​
Structured Input

​
Additional Input Options

Tip: For best results, use structured input with address components separated when possible. If data is unstructured, pass the complete address in Address1 and always separate the country into the Country field.
When an error occurs, the API returns an error response with the following structure:

​
Common Error Codes

Tip: Check the Resolution field for specific steps to fix the error. For more details on error responses, see International Batch Cleanse in API documentation.
Note: Address Verify corrects and standardizes addresses but does not validate whether an address is currently occupied or deliverable in real-time. It matches against reference datasets which may not reflect the most recent changes.

​
Try Address Verify

Test Address Verify using the International Batch Cleanse Playground to make your first request.

​
FAQ

Address Verify returns an AVC (Address Verification Code) that provides detailed information about address quality:
  • Verification level: How granularly the address matched (from broad Administrative Area to specific Delivery Point)
  • Parsing quality: How well the input address could be separated into components
  • Postal code accuracy: How precisely the postal code was verified
  • Matchscore: How much the address changed during verification (100 = no changes needed)
The AVC helps you decide whether to accept the verified address based on your requirements. For example, direct mail campaigns might require a matchscore of 95+, while other applications might accept 80+. Different countries support different verification levels—some validate to delivery point, others only to administrative area. See Country Data Coverage for details.
Address Verify handles addresses formatted in two main ways:
  • Complete address in a single field: Pass the entire address in Address1. Quick to implement but may reduce parsing accuracy
  • Address data divided into multiple fields: Separate known elements (city, postal code) into specific fields, and group mixed information together. Recommended for best results
We recommend the structured approach when possible: use Address1 for street information, then populate Locality, AdministrativeArea, PostalCode, and Country separately. This gives the verification engine more context and improves match rates.Always separate the Country field when possible, even in unstructured requests.
Use the AVC (Address Verification Code) for decision-making. While both codes describe address quality, they serve different purposes:
  • AVC: Detailed proprietary code showing verification level, parsing quality, and matchscore. Use this to decide whether to accept a verified address
  • AQI: Simplified quality indicator (A through F) providing a high-level view. Useful for reporting but not recommended for acceptance decisions
When deciding whether to accept a verified address, consider both:
  • How granular the verification was (from the AVC match level)
  • How much the address changed (from the AVC matchscore)
The AVC provides all this information in one code. See Address Verification Code documentation for full details.
Address Capture and Address Verify complement each other in the user journey:
  • Address Capture: Real-time type-ahead search providing verified addresses as users type
  • Address Verify: Validation and cleansing for manually entered or edited addresses
Example workflow for ecommerce checkout:
  1. User starts typing in address field, Address Capture provides verified suggestions
  2. If user selects from suggestions, then address is already verified
  3. If user manually enters or edits address, then Address Verify processes and cleanses it
  4. Use the AVC from Verify to decide whether to accept the address or prompt for corrections
This combination ensures all addresses are verified regardless of how they’re entered. Contact your account manager or Loqate support to learn more about using both products together.