# CustomerAddress - customer - OBJECT Version: 2024-10 ## Description Represents a customer's mailing address. For example, a customer's default address and an order's billing address are both mailing addresses. Apps using the Customer Account API must meet the protected customer data [requirements](https://shopify.dev/docs/apps/launch/protected-customer-data). ### Access Scopes ## Fields * [address1](/docs/api/customer/2024-10/scalars/String): String - The first line of the address. Typically the street address or PO Box number. * [address2](/docs/api/customer/2024-10/scalars/String): String - The second line of the address. This is typically the apartment, suite, or unit number. * [city](/docs/api/customer/2024-10/scalars/String): String - The name of the city, district, village, or town. * [company](/docs/api/customer/2024-10/scalars/String): String - The name of the customer's company or organization. * [country](/docs/api/customer/2024-10/scalars/String): String - The name of the country. * [firstName](/docs/api/customer/2024-10/scalars/String): String - The first name of the customer. * [formatted](/docs/api/customer/2024-10/scalars/String): String! - A formatted version of the address, customized by the provided arguments. * [formattedArea](/docs/api/customer/2024-10/scalars/String): String - A comma-separated list of the values for city, province, and country. * [id](/docs/api/customer/2024-10/scalars/ID): ID! - A globally-unique ID. * [lastName](/docs/api/customer/2024-10/scalars/String): String - The last name of the customer. * [name](/docs/api/customer/2024-10/scalars/String): String - The full name of the customer, based on firstName and lastName. * [phoneNumber](/docs/api/customer/2024-10/scalars/String): String - The customer's unique phone number. Formatted using E.164 standard. For example, _+16135551111_. * [province](/docs/api/customer/2024-10/scalars/String): String - The region of the address, such as the province, state, or district. * [territoryCode](/docs/api/customer/2024-10/enums/CountryCode): CountryCode - The two-letter code for the country of the address. For example, US. * [zip](/docs/api/customer/2024-10/scalars/String): String - The zip or postal code of the address. * [zoneCode](/docs/api/customer/2024-10/scalars/String): String - The alphanumeric code for the region. For example, ON. ## Connections ## Related queries ## Related mutations * [customerAddressCreate](/docs/api/customer/2024-10/mutations/customerAddressCreate) Creates a new address for a customer. * [customerAddressUpdate](/docs/api/customer/2024-10/mutations/customerAddressUpdate) Updates a specific address for a customer. ## Related Unions ## Examples