> This page is for Developer.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.bigcommerce.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server.

# CustomerAddress

GraphQL object

Address that is associated with a customer account.

Reference: https://docs.bigcommerce.com/developer/api-reference/graphql/storefront/types/objects/customer-address

## Fields

- `entityId` — Customer address ID.
- `firstName` — First name of the address owner.
- `lastName` — Last name of the address owner.
- `address1` — First line for the street address.
- `address2` — Second line for the street address.
- `addressType` — Address type (Residential or Commercial).
- `city` — City.
- `country` — Country name.
- `countryId` — Country ID as available in BigCommerce Geography (https://developer.bigcommerce.com/docs/rest-management/geography/countries#get-all-countries).
- `countryCode` — 2-letter country code.
- `stateOrProvince` — Name of State or Province.
- `stateId` — State Id as available in BigCommerce Geography (https://developer.bigcommerce.com/docs/rest-management/geography/states#get-all-states).
- `phone` — Phone number.
- `postalCode` — Postal code.
- `company` — Company name associated with the address.
- `formFields` — The form field values of the customer address.

## Definition

```graphql
type CustomerAddress {
  entityId: Int!
  firstName: String!
  lastName: String!
  address1: String!
  address2: String
  addressType: DestinationAddressType
  city: String!
  country: String
  countryId: Int
  countryCode: String!
  stateOrProvince: String
  stateId: Int
  phone: String
  postalCode: String
  company: String
  formFields: [CustomerFormFieldValue!]!
}
```