---
title: "The address object"
slug: "the-address-object"
abstract: "Describes the address object, which is part of the user object."
---
# The address object

The `address` object is located within the `user` object and represents the user's postal address information. This is usually also the billing address.

> [!important]
> If the `address` object is specified, then it must include at least one of the following key/value pairs.

The following table lists the attributes of the address object:

| Name | Type | Description |
| --- | --- | --- |
| `address_line_1` | string | Optional.<br><br>User address line one. |
| `address_line_2` | string | Optional.<br><br>User address line two. |
| `state` | string | Optional.<br><br>Two-letter code if in the US. |
| `zip` | string | Optional.<br><br>Five-digit zip code if in the US. |
| `country` | string | Optional.<br><br>Two-letter country code as defined by [ISO Alpha 2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Defaults to `"US"` |

To preserve users' privacy, all personally identifiable information, such as an email address, is encrypted. Additionally, address information is geocoded up to a precision of a 3-mile (approximately 5-kilometer) radius, so users' physical addresses cannot be pinpointed.