---
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`

## Request

- Base URL: `https://api.dintero.com/v1`
- URL: `https://api.dintero.com/v1/accounts/{aid}/search/external/address/{country}/validate`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/dintero/apis/account-management-api/docs/accounts/:aid/search/external/address/:country/validate/post.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/dintero/apis/account-management-api.md) - [All operations](https://skmtc.dev/dintero/apis/account-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dintero/apis/account-management-api/revisions/9b83a4199008?raw)