--- title: Validate Billing Address --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/typescript) [Billing](https://developers.cloudflare.com/api/typescript/resources/billing) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Validate Billing Address client.billing.addressValidation(BillingAddressValidationParams {address, address2, city, 3 more } body, RequestOptionsoptions?): [BillingAddressValidationResponse]() {validated\_addresses } POST/billing/address-validation Validates a billing address and returns validated address suggestions. Authentication is not enforced to support pre-signup address validation flows, so credentials are accepted but not required. ##### Security
API Token The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### ParametersExpand Collapse
body: BillingAddressValidationParams {address, address2, city, 3 more } address?: string Address line 1. Link to this property address2?: string Address line 2. Link to this property city?: string City. Link to this property country?: string Country code. Link to this property state?: string State or province. Link to this property zipcode?: string Postal or zip code. Link to this property
[Link to this property](<#(resource)%20billing%20%3E%20(method)%20address_validation%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
BillingAddressValidationResponse {validated\_addresses }
validated\_addresses?: Array<ValidatedAddress> List of validated address suggestions. address?: string Validated address line 1. Link to this property address2?: string Validated address line 2. Link to this property city?: string Validated city. Link to this property country?: string Validated country code. Link to this property state?: string Validated state or province. Link to this property validation\_code?: string The validation result code. Link to this property zipcode?: string Validated postal or zip code. Link to this property
Link to this property
[Link to this property](<#(resource)%20billing%20%3E%20(model)%20billing_address_validation_response%20%3E%20(schema)>) ### Validate Billing Address TypeScript HTTPTypeScriptPythonGoTerraform ``` import Cloudflare from 'cloudflare'; const client = new Cloudflare({ apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted }); const response = await client.billing.addressValidation(); console.log(response.validated_addresses); ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "result": { "validated_addresses": [ { "address": "address", "address2": "address2", "city": "city", "country": "country", "state": "state", "validation_code": "validation_code", "zipcode": "zipcode" } ] }, "success": true } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "result": { "validated_addresses": [ { "address": "address", "address2": "address2", "city": "city", "country": "country", "state": "state", "validation_code": "validation_code", "zipcode": "zipcode" } ] }, "success": true } ```