---
title: "Validate an address"
method: POST
path: "/v3/spend/address/validate"
tags: ["card-order"]
---

# Validate an address

`POST /v3/spend/address/validate`

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](/guides/developer/api-guides/card-address-validation).

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 %}

## Headers

- `X-External-Correlation-Id` string, uuid

## Request body

- object — Address to validate. Fields vary by country. See the [card address validation guide](/guides/developer/api-guides/card-address-validation).
  - `firstLine` string — Card holder's address (max 30 characters).
  - `secondLine` string, nullable — Card holder's address (max 30 characters).
  - `thirdLine` string, nullable — Card holder's address (max 30 characters).
  - `city` string — Card holder's city (max 30 characters).
  - `postCode` string — Card holder's postal code (max 10 characters).
  - `state` string, nullable — Card holder's state (max 30 characters).
  - `country` string — Card holder's country (ISO 3166-1 alpha-2, max 2 characters).

## Response `200`

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

- object
  - `errors` object[] — Collection of validation errors. Empty if address is valid.
    - `field` string — The field that failed validation.
    - `message` string — Description of the validation error.

## Other responses

- `429` — Rate limit exceeded. Retry after the number of seconds specified in the `Retry-After` header.

---

[API](https://skmtc.dev/wise/apis/platform-api.md) · [All operations](https://skmtc.dev/wise/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wise/platform-api/revisions/a688441e7042/schema)