---
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-04
api_name: customer
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/customer/2025-04/objects/CompanyAddress'
  md: 'https://shopify.dev/docs/api/customer/2025-04/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/2025-04/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/2025-04/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/2025-04/scalars/String)

  The city, district, village, or town.

* company​Name

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

  non-null

  The name of the company.

* country

  [String](https://shopify.dev/docs/api/customer/2025-04/scalars/String)

  The name of the country of the address.

* country​Code

  [Country​Code!](https://shopify.dev/docs/api/customer/2025-04/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/2025-04/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/2025-04/scalars/String)

  The first name of the recipient.

* formatted​Address

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

  non-null

  The formatted version of the address.

  * with​Name

    [Boolean](https://shopify.dev/docs/api/customer/2025-04/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/2025-04/scalars/Boolean)

    Default:true

    Whether to include the company name in the formatted address.

  ***

* formatted​Area

  [String](https://shopify.dev/docs/api/customer/2025-04/scalars/String)

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

* id

  [ID!](https://shopify.dev/docs/api/customer/2025-04/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/2025-04/scalars/String)

  The last name of the recipient.

* phone

  [String](https://shopify.dev/docs/api/customer/2025-04/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/2025-04/scalars/String)

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

* recipient

  [String](https://shopify.dev/docs/api/customer/2025-04/scalars/String)

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

* updated​At

  [Date​Time!](https://shopify.dev/docs/api/customer/2025-04/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/2025-04/scalars/String)

  The zip or postal code of the address.

* zone​Code

  [String](https://shopify.dev/docs/api/customer/2025-04/scalars/String)

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

***

## Map

### Fields with this object

* [CompanyLocation.billingAddress](https://shopify.dev/docs/api/customer/2025-04/objects/CompanyLocation#field-CompanyLocation.fields.billingAddress)
* [CompanyLocation.shippingAddress](https://shopify.dev/docs/api/customer/2025-04/objects/CompanyLocation#field-CompanyLocation.fields.shippingAddress)

***

## Mutations

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

  mutation

  Updates an address on a company location.

  * location​Id

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

    required

    ### Arguments

    The ID of the company location to update addresses on.

  * address

    [Company​Address​Input!](https://shopify.dev/docs/api/customer/2025-04/input-objects/CompanyAddressInput)

    required

    The input fields to use to update the address.

  * address​Types

    [\[Company​Address​Type!\]!](https://shopify.dev/docs/api/customer/2025-04/enums/CompanyAddressType)

    required

    The list of address types on the location to update.

  ***

***

## CompanyAddress Mutations

### Mutated by

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

***

## Interfaces

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

  interface

***

## CompanyAddress Implements

### Implements

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