---
title: "Standardize and validate an address"
method: POST
path: "/addresses/standardize"
tags: ["AddressStandardization"]
---

# Standardize and validate an address

`POST /addresses/standardize`

Returns the standardized address together with a confidence tier (HIGH/MEDIUM/LOW), a validation status (VALID/PARTIAL/INVALID), and enrichment data (ZIP+4, county, lat/long, timezone). Pass-through to the DAL address cleanser.

## Headers

- `tenant-id` string, required

## Request body

- StandardizeAddressRequest — Input address to be standardized and validated
  - `addressLine1` string, required — Primary street line
  - `addressLine2` string — Secondary street line (apt, suite, unit, floor)
  - `city` string — City
  - `county` string — County
  - `state` string — State / province code
  - `zip` string — ZIP / postal code (5 or 5+4, hyphen-separated)
  - `country` string — ISO country code
  - `addressType` string — Optional address type hint (e.g. billing, mailing, office, remit_to, service, irs)

## Response `200`

Address standardized successfully

- StandardizeAddressResponse — Standardized address with confidence, validation status, and enrichment data
  - `standardizedAddress` StandardizedAddress — Standardized address components
    - `addressLine1` string — Standardized primary street line
    - `addressLine2` string — Standardized secondary street line
    - `city` string — Standardized city
    - `county` string — Standardized county
    - `state` string — Standardized state code
    - `zip` string — Standardized ZIP / postal code
    - `zip4` string — ZIP+4 extension, if available
    - `country` string — Country code
    - `formattedAddress` string — Pretty-printed single-line address
  - `confidence` 'HIGH' | 'MEDIUM' | 'LOW'
  - `validationStatus` 'VALID' | 'PARTIAL' | 'INVALID'
  - `enrichment` AddressEnrichment — Enrichment values attached to the standardized address
    - `zip4` string — ZIP+4 extension, if available
    - `county` string — County name, if available
    - `latitude` number, double — Latitude in decimal degrees, if available
    - `longitude` number, double — Longitude in decimal degrees, if available
    - `stateFips` string — 2-digit state FIPS code, if available
    - `countyFips` string — 5-digit county FIPS code, if available
    - `formattedAddress` string — Pretty-printed single-line address, if available
    - `timezone` string — IANA timezone ID, if available; always null until timezone enrichment ships

## Other responses

- `204` — Address cleanser is disabled globally; no content returned
- `400` — Invalid request payload
- `401` — Unauthorized - Authentication required
- `403` — Forbidden - Tenant header missing or insufficient permissions
- `500` — Internal server error
- `502` — Bad Gateway - DAL cleanser unavailable

---

[API](https://skmtc.net/certifyos/apis/certify-api-layer.md) · [All operations](https://skmtc.net/certifyos/apis/certify-api-layer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/certifyos/certify-api-layer/revisions/3d27e9019c7b/schema)