🇺🇸 US Address Validation Status Codes – Decoding Guide
1️⃣ HRX_UV – User Verified (Manual Override)
| Code | Meaning | Action Required |
|---|---|---|
| HRX_UV01 | Address marked as user verified (not validated by service provider) | ⚠ Review carefully. Consider re-validating unless intentionally overridden. |
👉 Used when users bypass USPS validation.
2️⃣ HRX_US_AC – Address Corrections (System Adjustments)
These indicate automatic corrections made by the validation service.
| Code | What Was Corrected | Risk Level |
|---|---|---|
| AC01 | ZIP Code added/changed | Medium |
| AC02 | State added/changed | High |
| AC03 | City added/changed | High |
| AC09 | Dependent locality added/changed | Low |
| AC10 | Street spelling corrected | Low |
| AC11 | Street suffix corrected (St → Rd) | Low |
| AC12 | Direction corrected (N → NW) | Medium |
| AC13 | Unit type corrected (STE → APT) | Medium |
| AC14 | Unit number added/changed | High |
| AC16 | County added/changed | Low |
| AC18 | PO Box corrected | High |
| AC19 | Premise type corrected | Medium |
Governance Tip
If State, City, ZIP, Unit Number are auto-corrected → review before committing Final mode.
3️⃣ HRX_US_AE – Address Errors (Must Be Fixed)
These are hard validation failures.
Addresses with these should NOT be committed in Final mode.
🔴 Critical Structural Errors
| Code | Meaning | Action |
|---|---|---|
| AE01 | ZIP missing/incorrect | Fix ZIP |
| AE07 | Missing State/City/ZIP | Complete address |
| AE10 | Street number not found | Correct house number |
| AE11 | Street number missing | Enter house number |
These are mandatory fields for payroll tax accuracy.
🟠 Matching Failures
| Code | Meaning |
|---|---|
| AE02 | Street not found or too many matches |
| AE03 | Direction + suffix combination ambiguous |
| AE05 | Insufficient info to match |
These require clarification of street or direction details.
🟡 Unit / Box Issues
| Code | Meaning |
|---|---|
| AE08 | Unit number not found |
| AE09 | Unit number missing |
| AE12 | PO/RR/HC Box not found |
| AE13 | PO/RR/HC Box missing |
| AE14 | Private mailbox missing |
Important for apartment, suite, CMRA addresses.
4️⃣ HRX_US_AV – Validation Quality Level
These indicate how precisely the address was verified.
Lower Precision (Partial Validation)
| Code | Verified To |
|---|---|
| AV11 / AV21 | State only |
| AV12 / AV22 | City only |
| AV13 / AV23 | Street name |
| AV14 / AV24 | Street number / Premise |
AV11–14 = service could verify
AV21–24 = system confirmed verification level
Highest Precision
| Code | Meaning |
|---|---|
| AV25 | Verified to unit number (Apartment/Suite/PO Box) |
✅ This is the gold standard for payroll and taxation accuracy.
5️⃣ HRX_US_GS – Geospatial Accuracy
These indicate how precisely latitude/longitude was determined.
| Code | Geocode Level | Accuracy |
|---|---|---|
| GS01 | Street level | Medium |
| GS02 | Neighborhood | Medium-Low |
| GS03 | Community | Low |
| GS04 | State | Very Low |
| GS05 | Rooftop/building | Very High |
| GS06 | Within property boundary | Highest |
For compliance-heavy industries, aim for GS05 or GS06.
🎯 Recommended Operational Standard
| Category | Recommended Condition Before Final Mode |
|---|---|
| AE Codes | ❌ None remaining |
| AV Codes | Prefer AV24 or AV25 |
| GS Codes | Prefer GS05 or GS06 |
| AC Codes | Review major corrections |
🔁 Decision Matrix for Payroll Readiness
| Scenario | Can You Move to Final Mode? |
|---|---|
| AE present | ❌ No |
| Only AV11–AV13 | ⚠ Review |
| AV24 + GS05 | ✅ Yes |
| AC02 (State changed) | ⚠ Manual review |
| UV01 only | ⚠ Consider re-validation |
🏁 Maturity Model
Basic Level
No AE errors
AV24 minimum
Controlled Level
AV25 preferred
GS05+ geocoding
No major AC corrections
Optimized Level
Scheduled quarterly validation
No UV01 overrides
Exception reporting enabled
Comments
Post a Comment