Validate and standardize a US address without saving it.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Overview
Validate and standardize a US address without saving it. The endpoint runs the address through USPS CASS processing and returns the corrected address together with its parsed components, Delivery Point Validation (DPV) result, and postal routing metadata. No address is created or stored.
Use it to verify an address before saving it, or to power an address-verification experience.
Providing the address
Submit either a single free-form address string or the individual components (line1, city, state, postal_code, and so on). When both are provided, the explicit components take precedence.
The free-form address accepts comma-separated and multi-line input, and a trailing country (for example United States or USA) is removed automatically.
Response
The result is grouped to make it easy to consume:
| Group | Description |
|---|---|
address | The corrected, mailable address. |
components | The parsed USPS address components (street, secondary unit, city, state, ZIP and ZIP+4). |
dpv | The Delivery Point Validation result — whether the address is a confirmed, deliverable point, plus flags such as cmra, vacant and no_stat. |
metadata | Postal routing and geographic reference data: county, carrier route, congressional district, delivery point, barcode and eLOT. |
The analysis is always returned, even when an address cannot be confirmed for delivery, so the result can be surfaced to the user.
Notes
- Address cleansing currently supports US addresses only.
- The feature must be enabled on your account; when it is not, the endpoint responds with
403.