;
};
**Validate and correct addresses in real-time to reduce delivery failures and ensure data quality.**
## Who Should Use This Guide
**For:** Business owners and developers integrating address verification without complex setup.
**You'll need:** A Loqate API key and basic HTML knowledge.
**Not covered:** Tag-based integrations ([see Tag Setup](/our-services/tag-setup-guide)), batch processing of large address lists, or CASS/SERP certification workflows.
## What You'll Build
An address verification form that:
* Validates addresses against postal datasets
* Corrects errors and typos automatically
* Standardizes address formatting
* Shows match quality scores (AVC codes)
* Works with addresses in 250+ countries
## Quick Start
To set up Address Verify, you'll need an API key. Find out how to get yours [here](/loqate-basics/create-an-api-key/).
### Choose Your Approach
**Use case:** Testing the API or adding to a static page
A self-contained HTML file you can copy and use immediately.
Jump to [standalone HTML example](#standalone-html-example)
**Use case:** Add verification to your current checkout or registration forms
Step-by-step guide to add verification code to forms you already have.
Jump to [integration example](#integration-example)
**Using Shopify or WordPress?** Check [pre-built integrations](/integrations/all-integrations).
### Add Your Key
Replace `YOUR_API_KEY` in the code with your actual Loqate API key.
### Test
1. Open your page
2. Enter an address with typos like "123 Mane Street, Bostan MA"
3. Click verify
4. See the corrected address: "123 Main Street, Boston MA"
Address Verify validates against postal datasets for 250+ countries. Match quality is indicated by AVC codes (V44 = perfect match, V33 = good match, etc.).
***
## Sample Project: Checkout Form Integration
This walkthrough shows how to add address verification to a checkout form. Follow along to see a basic form transform into a verification-enabled form.
This is a detailed walkthrough. If you just want working code, skip to [Integration Example](#integration-example) or [Standalone HTML Example](#standalone-html-example).
### Before: Unverified Address Entry
A checkout form without verification:
**This form works, but doesn't verify or correct addresses.** Let's add verification.
***
## How Address Verify Works
Address Verify validates addresses in a single API call:
### The Verification Process
**Input:** You send address fields (street, city, postal code, country)
**Processing:** The API:
1. Parses the input fields
2. Matches against postal reference data
3. Corrects typos and standardizes formatting
4. Returns match quality scores
**Output:** You receive:
* Corrected address in standardized format
* AVC code indicating match quality
* Original input for comparison
### Understanding AVC Codes
The AVC (Address Verification Code) tells you match quality:
**Format:** `V44-I44-P7-100`
**Key components:**
* **First character:** Verification status
* `V` = Verified (use this address)
* `P` = Partially verified (check details)
* `U` = Unverified (rejected)
* **Match level (2nd-3rd characters):**
* `44` = Premise level (street + number) - Best
* `33` = Street level
* `22` = Locality level (city)
* Lower = Less precise
* **Final number:** Match percentage
* `100` = Perfect match, no changes
* `95-99` = Minor corrections
* `80-94` = Significant corrections
* Below 80 = Major issues
**Decision guide:**
* `V44` with 95+ matchscore = Accept automatically
* `V33` or `V44` with 80-94 = Review changes, usually accept
* `V22` or below = Reject or ask user to verify
* `P` or `U` = Reject
***
## Standalone HTML Example
A minimal address verification form for quick testing:
**Perfect for:**
* Quick API testing
* Learning how address verification works
* Simple integrations without checkout flows
**To use:**
1. Copy the code
2. Replace `YOUR_API_KEY`
3. Save and test with different addresses
This example shows original vs corrected addresses side-by-side with the AVC code for learning purposes.
## Code on GitHub
If you'd like to browse the code snippets in this implementation guide or clone them, visit the repository on [GitHub](https://github.com/loqate/javascript-docs-sample/tree/main/address-verify).
## Integration Example
Here's the checkout form with full address verification integrated:
**To use this code:**
1. Copy the code
2. Replace `YOUR_API_KEY` with your actual Loqate API key
3. Save as an HTML file
4. Open in a browser to test
5. Customize styling to match your brand
**Key features in this example:**
* Real-time verification on form submission
* Shows before/after comparison
* Automatic field updates with corrected values
* Accept/reject workflow based on AVC
* Clean, production-ready code structure
This example accepts addresses with V44/V33 match levels and 80+ matchscore. Adjust thresholds based on your requirements.
***
## Integration Tips
### Adding to Your Existing Forms
To add address verification to your current forms:
1. **Add the verification function** from the integration example to your page's `