---
title: "Pre-validate KYC address"
method: POST
path: "/v1/phone-numbers/kyc/validate-address"
tags: ["Phone Numbers"]
---

# Pre-validate KYC address

`POST /v1/phone-numbers/kyc/validate-address`

Optional early check for the address step of a Tier 4 (end-user identity)
registration: validates a postal address for deliverability BEFORE the full
KYC submit, so it can be corrected before any documents are uploaded. The
full submit (POST /v1/phone-numbers/kyc) re-validates the address,
so this call is purely a fast feedback path and skipping it is safe. Only
the postal address is sent (no documents, no gov-ID fields). A region
(`administrative_area`) is required by the validator; when it is omitted the
pre-check is skipped and `{ ok: true, skipped: true }` is returned (the
final submit still validates).

## Request body

- object
  - `country` string, required — ISO 3166-1 alpha-2 country code.
  - `street_address` string, required
  - `extended_address` string — Address complement: apartment, suite, unit, or the quadra/lote used in some countries. Optional. Does not substitute for a building number on street_address.
  - `locality` string, required — City / town.
  - `administrative_area` string — State / province / region. When omitted, the pre-check is skipped (the final submit still validates).
  - `postal_code` string, required

## Response `200`

Address is deliverable, or the pre-check was skipped (no region supplied).

- object
  - `ok` boolean
  - `skipped` boolean — true when no `administrative_area` was supplied, so no pre-check ran.

## Other responses

- `400` — The country isn't offered, or the address could not be verified. When the provider returned usable corrections, `details.addressSuggestions` carries them per field for a one-click "apply suggestion" card. (Flat error envelope: `error` is the human message; `code`/`param`/`details` are top-level siblings.)
- `401` — Unauthorized

---

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