Sign in

v5

latestOpenAPI 3.1.02026-07-262421791.5 MB
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 card creation, the address requirement depends on the card type:

  • Physical Cards (Required): Used as the delivery address to ship the card and for AVS checks in countries where required.

  • Virtual Cards (Optional): If provided, this acts as the billing address. If omitted, the profile address is used as the fallback. In either scenario, the address is used for AVS checks in countries where 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"
    }
  ]
}