---
title: SubscriptionMailingAddress - Customer API
description: The mailing address on a subscription.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/customer/latest/objects/SubscriptionMailingAddress
  md: >-
    https://shopify.dev/docs/api/customer/latest/objects/SubscriptionMailingAddress.md
api_name: customer
api_type: graphql
type: object
---

# Subscription​Mailing​Address

object

Requires `customer_read_customers` access scope.

The mailing address on a subscription.

## Fields

* address1

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

  The first line of the address, 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, typically the apartment, suite, or unit number.

* city

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

  The name of the city, district, village, or town.

* company

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

  The name of the customer's company or organization.

* country

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

  The name of the country.

* country​Code

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

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

* first​Name

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

  The first name of the customer.

* last​Name

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

  The last name of the customer.

* name

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

  The full name of the customer, based on the first name and last name.

* phone

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

  A unique phone number for 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.

* province​Code

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

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

* zip

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

  The zip or postal code of the address.

***

## Map

### Fields with this object

* [SubscriptionDeliveryMethodLocalDelivery.address](https://shopify.dev/docs/api/customer/latest/objects/SubscriptionDeliveryMethodLocalDelivery#field-SubscriptionDeliveryMethodLocalDelivery.fields.address)
* [SubscriptionDeliveryMethodShipping.address](https://shopify.dev/docs/api/customer/latest/objects/SubscriptionDeliveryMethodShipping#field-SubscriptionDeliveryMethodShipping.fields.address)