Sign in
card-order

Validate an address

Validates the format of an address for a card order. Make sure to follow country-specific address fields and validation as described in the card address validation guide.

For virtual cards, the address field will be used as a billing address. It will be used for AVS checks in countries where it is required.

For physical cards, the address field will be used as a delivery address. It will be used to deliver your card and for AVS checks in countries where it is required.

{% admonition type="warning" %} We do not support PO BOX addresses. {% /admonition %}

post/v3/spend/address/validate

Headers

X-External-Correlation-Idstring uuid

Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more.

Request body

firstLinestring

Card holder's address (max 30 characters).

secondLinestring nullable

Card holder's address (max 30 characters).

thirdLinestring nullable

Card holder's address (max 30 characters).

citystring

Card holder's city (max 30 characters).

postCodestring

Card holder's postal code (max 10 characters).

statestring nullable

Card holder's state (max 30 characters).

countrystring

Card holder's country (ISO 3166-1 alpha-2, max 2 characters).

Example request

{
  "firstLine": "56 Shoreditch High St",
  "secondLine": "The Tea Bldg",
  "city": "London",
  "postCode": "E1 6JJ",
  "country": "GB"
}

Response

OK - Validation result returned. An empty errors collection means the address is valid.

Example response

{
  "errors": [
    {
      "field": "postCode",
      "message": "Please enter a valid postcode"
    }
  ]
}

Changes