---
title: "Validate an address"
method: POST
path: "/addresses/actions/validate"
tags: ["Addresses"]
---

# Validate an address

`POST /addresses/actions/validate`

Validates an address for emergency services.

## Request body

- ValidateAddressRequest
  - `administrative_area` string — The locality of the address. For US addresses, this corresponds to the state of the address.
  - `country_code` string, required — The two-character (ISO 3166-1 alpha-2) country code of the address.
  - `extended_address` string — Additional street address information about the address such as, but not limited to, unit number or apartment number.
  - `locality` string — The locality of the address. For US addresses, this corresponds to the city of the address.
  - `postal_code` string, required — The postal code of the address.
  - `street_address` string, required — The primary street address information about the address.

## Response `200`

Action response

- object
  - `data` ValidateAddressResult
    - `errors` Error[]
      - `code` string, required
      - `description` string
      - `meta` object
      - `source` object
        - `parameter` string — Indicates which query parameter caused the error.
        - `pointer` string, json-pointer — JSON pointer (RFC6901) to the offending entity.
      - `title` string, required
    - `record_type` string — Identifies the type of the resource.
    - `result` 'valid' | 'invalid', required — Indicates whether an address is valid or invalid.
    - `suggested` ValidateAddressField, required
      - `administrative_area` string — The locality of the address. For US addresses, this corresponds to the state of the address.
      - `country_code` string — The two-character (ISO 3166-1 alpha-2) country code of the address.
      - `extended_address` string — Additional street address information about the address such as, but not limited to, unit number or apartment number.
      - `locality` string — The locality of the address. For US addresses, this corresponds to the city of the address.
      - `postal_code` string — The postal code of the address.
      - `street_address` string — The primary street address information about the address.

## Other responses

- `422` — Bad request

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/1571b0380bd7/schema)