---
title: "POST /providers/Microsoft.Billing/validateAddress"
method: POST
path: "/providers/Microsoft.Billing/validateAddress"
tags: ["Address"]
---

# POST /providers/Microsoft.Billing/validateAddress

`POST /providers/Microsoft.Billing/validateAddress`

Validates an address. Use the operation to validate an address before using it as a billing account or a billing profile address.

## Query parameters

- `api-version` string, required

## Request body

- AddressDetails — Address details.
  - `firstName` string — First name.
  - `lastName` string — Last name.
  - `companyName` string — Company name.
  - `addressLine1` string — Address line 1.
  - `addressLine2` string — Address line 2.
  - `addressLine3` string — Address line 3.
  - `city` string — Address city.
  - `region` string — Address region.
  - `country` string — Country code uses ISO2, 2-digit format.
  - `postalCode` string — Postal code.

## Response `200`

OK. The request has succeeded.

- ValidateAddressResponse — Result of the address validation
  - `status` 'Valid' | 'Invalid' — Status of the address validation.
  - `suggestedAddresses` AddressDetails[] — The list of suggested addresses.
    - `firstName` string — First name.
    - `lastName` string — Last name.
    - `companyName` string — Company name.
    - `addressLine1` string — Address line 1.
    - `addressLine2` string — Address line 2.
    - `addressLine3` string — Address line 3.
    - `city` string — Address city.
    - `region` string — Address region.
    - `country` string — Country code uses ISO2, 2-digit format.
    - `postalCode` string — Postal code.
  - `validationMessage` string — Validation error message.

## Other responses

- `default` — Error response describing why the operation failed.

---

[API](https://skmtc.net/azure/apis/billingmanagementclient.md) · [All operations](https://skmtc.net/azure/apis/billingmanagementclient/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/billingmanagementclient/versions/481e7355ac16/schema)