---
title: "Validate a US mailing address."
method: POST
path: "/v1/addresses/validate"
---

# Validate a US mailing address.

`POST /v1/addresses/validate`

## Request

- Base URL: `https://paperagent.dev`
- URL: `https://paperagent.dev/v1/addresses/validate`
- Auth: none required

## Request body

- object
  - `address` object, required
    - `name` string
    - `line1` string, required
    - `line2` string
    - `city` string, required
    - `state` string, required
    - `zip5` string, required
    - `zip4` string

## Response `200`

Success

- object
  - `deliverable` boolean, required
  - `address` object, nullable, required
    - `line1` string, required
    - `line2` string
    - `city` string, required
    - `state` string, required
    - `zip5` string, required
    - `zip4` string
    - `deliverable` boolean, required
    - `dpv` object
      - `confirmed` 'Y' | 'N' | 'S' | 'D', required
      - `vacant` boolean
      - `cmra` boolean
  - `corrections` string[], required
  - `message` string, required

## Other responses

- `default`: A stable error code and actionable message. 401: authenticate; 403: permission or policy; 404: unavailable object; 409: conflict; 422: domain refusal; 429: quota; 5xx: retry or contact support.

---

[API](https://skmtc.dev/paperagent/apis/paperagent-rest-api.md) · [All operations](https://skmtc.dev/paperagent/apis/paperagent-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/paperagent/apis/paperagent-rest-api/revisions/388148938051?raw)