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

## 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.net/wise/apis/platform-api.md) · [All operations](https://skmtc.net/wise/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wise/platform-api/revisions/4907a1d269ab/schema)