# Addresses

> For the complete machine-readable documentation index, see [llms.txt](https://apidocs.chargebee.com/llms.txt).


Subscriptions can have addresses like "Shipping Address" associated with them. This is apart from the billing address as part of credit card information.

## Sample Address

```json
{
  "addr": "PO Box 9999",
  "city": "Walnut",
  "country": "US",
  "first_name": "John",
  "label": "shipping_address",
  "last_name": "Doe",
  "object": "address",
  "state": "California",
  "state_code": "CA",
  "subscription_id": "__test__KyVnHhSBWm2yX2rX",
  "validation_status": "not_validated",
  "zip": "91789"
}
```

## Addresses attributes

## Input Parameters

- `label` (required, string, max chars=50)
  Label to identify the address. This is unique for all the address for a subscription.

- `first_name` (optional, string, max chars=150)
  First name

- `last_name` (optional, string, max chars=150)
  Last name

- `email` (optional, string, max chars=70)
  Email

- `company` (optional, string, max chars=250)
  Company name

- `phone` (optional, string, max chars=50)
  Phone number

- `addr` (optional, string, max chars=150)
  Address line 1

- `extended_addr` (optional, string, max chars=150)
  Address line 2

- `extended_addr2` (optional, string, max chars=150)
  Address line 3

- `city` (optional, string, max chars=50)
  Name of the city

- `state_code` (optional, string, max chars=50)
  The [ISO 3166-2 state/province code](https://www.iso.org/obp/ui/#search) without the country prefix. Currently supported for USA, Canada, India and UAE. For instance, for Arizona (USA), set `state_code` as `AZ` (not `US-AZ` ). For Tamil Nadu (India), set as `TN` (not `IN-TN` ). For British Columbia (Canada), set as `BC` (not `CA-BC` ). For Dubai (UAE), set as `DU` (not `AE-DU` ).

- `state` (optional, string, max chars=50)
  State or Province

- `country` (optional, string, max chars=50)
  The billing address country of the customer. Must be one of [ISO 3166 alpha-2 country code](https://www.iso.org/iso-3166-country-codes.html) .
  
  **Note**: If you enter an invalid country code, the system will return an error.
  
  **Brexit**
  
  If you have enabled [EU VAT](https://www.chargebee.com/docs/eu-vat.html) in 2021 or later, or have [manually enable](https://www.chargebee.com/docs/brexit.html#what-needs-to-be-done-in-chargebee) the Brexit configuration, then `XI` (the code for **United Kingdom - Northern Ireland**) is available as an option.

- `zip` (optional, string, max chars=20)
  Zip or postal code. The number of characters is validated according to the rules [specified here](https://chromium-i18n.appspot.com/ssl-address) .

- `validation_status` (optional, enumerated string, default=not_validated)
  The address verification status.
  Possible enum values:
    - `not_validated`
      Address is not yet validated.
    - `valid`
      Address was validated successfully.
    - `partially_valid`
      The address is valid for taxability but has not been validated for shipping.
    - `invalid`
      Address is invalid.

- `subscription_id` (required, string, max chars=50)
  A unique and immutable identifier for the subscription. If not provided, it is autogenerated.