---
title: "aid_search_external_validate_address"
method: POST
path: "/accounts/{aid}/search/external/address/{country}/validate"
tags: ["addresses"]
---

# aid_search_external_validate_address

`POST /accounts/{aid}/search/external/address/{country}/validate`

Validate the given address and return close matching alternative
suggestions if the provided address was most likely wrong.

scopes:
- public

## Path parameters

- `aid` string, ^[PT]{1}\d{8}$, required
- `country` string, required

## Request body

- object
  - `address_line` string, required
  - `address_line_2` string
  - `postal_code` string, required
  - `postal_place` string, required
  - `country` string, iso-3166-1, required — ISO 3166-1 country code

## Response `200`

Result with close matching alternative addresses if found.

- AddressValidationResult
  - `valid` boolean, required — If the address was valid or not.
  - `alternatives` object[], required — Close matching alternative addresses.
    - `address_line` string, required
    - `address_line_2` string
    - `postal_code` string, required
    - `postal_place` string, required
    - `country` string, iso-3166-1, required — ISO 3166-1 country code

## Other responses

- `400` — Bad / Invalid request
- `404` — Resource was not found
- `429` — Too Many Requests
- `500` — Unexpected Error

---

[API](https://skmtc.net/dintero/apis/account-management-api.md) · [All operations](https://skmtc.net/dintero/apis/account-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dintero/account-management-api/revisions/9b83a4199008/schema)