---
title: CompanyAddress - Customer API
description: The address of a company location, either billing or shipping. Apps using the Customer Account API must meet the protected customer data [requirements](https://shopify.dev/docs/apps/launch/protected-customer-data).
api_version: 2025-10
api_name: customer
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/customer/latest/objects/companyaddress
  md: https://shopify.dev/docs/api/customer/latest/objects/companyaddress.md
---

# Company​Address

object

The address of a company location, either billing or shipping. Apps using the Customer Account API must meet the protected customer data [requirements](https://shopify.dev/docs/apps/launch/protected-customer-data).

## Fields

* address1

  [String!](https://shopify.dev/docs/api/customer/latest/scalars/String)

  non-null

  The first line of the address. It is typically the street address or PO Box number.

* address2

  [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

  The second line of the address. It is typically the apartment, suite, or unit number.

* city

  [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

  The city, district, village, or town.

* company​Name

  [String!](https://shopify.dev/docs/api/customer/latest/scalars/String)

  non-null

  The name of the company.

* country

  [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

  The name of the country of the address.

* country​Code

  [Country​Code!](https://shopify.dev/docs/api/customer/latest/enums/CountryCode)

  non-null

  The two-letter code for the country of the address, for example, US.

* created​At

  [Date​Time!](https://shopify.dev/docs/api/customer/latest/scalars/DateTime)

  non-null

  The date and time (in [ISO 8601 format](http://en.wikipedia.org/wiki/ISO_8601)) when the company address was created.

* first​Name

  [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

  The first name of the recipient.

* formatted​Address

  [\[String!\]!](https://shopify.dev/docs/api/customer/latest/scalars/String)

  non-null

  The formatted version of the address.

  * with​Name

    [Boolean](https://shopify.dev/docs/api/customer/latest/scalars/Boolean)

    Default:false

    ### Arguments

    Whether to include the name of the recipient in the formatted address.

  * with​Company​Name

    [Boolean](https://shopify.dev/docs/api/customer/latest/scalars/Boolean)

    Default:true

    Whether to include the company name in the formatted address.

  ***

* formatted​Area

  [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

  A comma-separated list of the city, province, and country values.

* id

  [ID!](https://shopify.dev/docs/api/customer/latest/scalars/ID)

  non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  A globally-unique ID.

* last​Name

  [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

  The last name of the recipient.

* phone

  [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

  The unique phone number of the customer, formatted using the E.164 standard, for example, *+16135551111*.

* province

  [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

  The region of the address, such as the province, state, or district.

* recipient

  [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

  The identity of the recipient, for example, 'Receiving Department'.

* updated​At

  [Date​Time!](https://shopify.dev/docs/api/customer/latest/scalars/DateTime)

  non-null

  The date and time (in [ISO 8601 format](http://en.wikipedia.org/wiki/ISO_8601)) when the company address was last updated.

* zip

  [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

  The zip or postal code of the address.

* zone​Code

  [String](https://shopify.dev/docs/api/customer/latest/scalars/String)

  The alphanumeric code for the region, for example, ON.

***

## Map

### Fields with this object

* {}[CompanyLocation.billingAddress](https://shopify.dev/docs/api/customer/latest/objects/CompanyLocation#field-billingAddress)
* {}[CompanyLocation.shippingAddress](https://shopify.dev/docs/api/customer/latest/objects/CompanyLocation#field-shippingAddress)

***

## Mutations

* [company​Location​Assign​Address](https://shopify.dev/docs/api/customer/latest/mutations/companyLocationAssignAddress)

  mutation

  Updates an address on a company location.

***

## <\~> CompanyAddress Mutations

### Mutated by

* <\~>[company​Location​Assign​Address](https://shopify.dev/docs/api/customer/latest/mutations/companyLocationAssignAddress)

***

## Interfaces

* [Node](https://shopify.dev/docs/api/customer/latest/interfaces/Node)

  interface

***

## ||-CompanyAddress Implements

### Implements

* ||-[Node](https://shopify.dev/docs/api/customer/latest/interfaces/Node)