---
title: Customer Address
description: >-
  Manage the customer addresses for a store. Customers can have multiple
  addresses, one of which is the default address that's used to calculate taxes
  and shipping charges.
api_version: 2026-07
source_url:
  html: 'https://shopify.dev/docs/api/admin-rest/latest/resources/customer-address'
  md: 'https://shopify.dev/docs/api/admin-rest/latest/resources/customer-address.md'
api_name: admin-rest
api_type: rest
---

The REST Admin API is a legacy API as of October 1, 2024. Starting April 1, 2025, all new public apps must be built exclusively with the [GraphQL Admin API](https://shopify.dev/docs/api/admin-graphql). For details and migration steps, visit our [migration guide](https://shopify.dev/docs/apps/build/graphql/migrate).

# Customer Address

**Requires \`customers\` access scope.:**

**Requires access to \[protected customer data]\(https://shopify.dev/apps/store/data-protection/protected-customer-data).:**

The Customer Address resource represents addresses that a customer has added. Each customer can have multiple addresses associated with them.

For more information about the Customer resource, see [*Customer*](https://shopify.dev/docs/admin-api/rest/reference/customers/customer).

\#

## Endpoints

* [post](https://shopify.dev/docs/api/admin-rest/latest/resources/customer-address.md#post-customers-customer-id-addresses)

  [/admin/api/latest/customers/{customer\_​id}/addresses.​json](https://shopify.dev/docs/api/admin-rest/latest/resources/customer-address.md#post-customers-customer-id-addresses)

  Creates a new address for a customer

  [customerUpdate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerUpdate?example=creates-a-new-address-for-a-customer)

* [get](https://shopify.dev/docs/api/admin-rest/latest/resources/customer-address.md#get-customers-customer-id-addresses?limit=1)

  [/admin/api/latest/customers/{customer\_​id}/addresses.​json?limit=1](https://shopify.dev/docs/api/admin-rest/latest/resources/customer-address.md#get-customers-customer-id-addresses?limit=1)

  Retrieves a list of addresses for a customer

  [customer](https://shopify.dev/docs/api/admin-graphql/latest/queries/customer?example=retrieves-a-list-of-addresses-for-a-customer)

* [get](https://shopify.dev/docs/api/admin-rest/latest/resources/customer-address.md#get-customers-customer-id-addresses-address-id)

  [/admin/api/latest/customers/{customer\_​id}/addresses/{address\_​id}.​json](https://shopify.dev/docs/api/admin-rest/latest/resources/customer-address.md#get-customers-customer-id-addresses-address-id)

  Retrieves details for a single customer address

  [customer](https://shopify.dev/docs/api/admin-graphql/latest/queries/customer)

* [put](https://shopify.dev/docs/api/admin-rest/latest/resources/customer-address.md#put-customers-customer-id-addresses-address-id)

  [/admin/api/latest/customers/{customer\_​id}/addresses/{address\_​id}.​json](https://shopify.dev/docs/api/admin-rest/latest/resources/customer-address.md#put-customers-customer-id-addresses-address-id)

  Updates an existing customer address

  [customerUpdateDefaultAddress](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerUpdateDefaultAddress?example=updates-an-existing-customer-address)

* [put](https://shopify.dev/docs/api/admin-rest/latest/resources/customer-address.md#put-customers-customer-id-addresses-address-id-default)

  [/admin/api/latest/customers/{customer\_​id}/addresses/{address\_​id}/default.​json](https://shopify.dev/docs/api/admin-rest/latest/resources/customer-address.md#put-customers-customer-id-addresses-address-id-default)

  Sets the default address for a customer

  [customerUpdateDefaultAddress](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerUpdateDefaultAddress?example=sets-the-default-address-for-a-customer)

* [put](https://shopify.dev/docs/api/admin-rest/latest/resources/customer-address.md#put-customers-customer-id-addresses-set?address-ids\[]=1053317309\&operation=destroy)

  [/admin/api/latest/customers/{customer\_​id}/addresses/set.​json?address\_​ids\[\]=1053317309\&operation=destroy](https://shopify.dev/docs/api/admin-rest/latest/resources/customer-address.md#put-customers-customer-id-addresses-set?address-ids\[]=1053317309\&operation=destroy)

  Performs bulk operations for multiple customer addresses

  [customerUpdate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerUpdate?example=performs-bulk-operations-for-multiple-customer-addresses)

* [del](https://shopify.dev/docs/api/admin-rest/latest/resources/customer-address.md#delete-customers-customer-id-addresses-address-id)

  [/admin/api/latest/customers/{customer\_​id}/addresses/{address\_​id}.​json](https://shopify.dev/docs/api/admin-rest/latest/resources/customer-address.md#delete-customers-customer-id-addresses-address-id)

  Removes an address from a customer’s address list

***

## The Customer Address resource

### Properties

***

address1

->[address1](https://shopify.dev/docs/api/admin-graphql/latest/objects/MailingAddress#field-MailingAddress.fields.address1)

The customer's mailing address

***

address2

->[address2](https://shopify.dev/docs/api/admin-graphql/latest/objects/MailingAddress#field-MailingAddress.fields.address2)

An additional field for the customer's mailing address.

***

city

->[city](https://shopify.dev/docs/api/admin-graphql/latest/objects/MailingAddress#field-MailingAddress.fields.city)

The customer's city, town, or village.

***

country

->[country](https://shopify.dev/docs/api/admin-graphql/latest/objects/MailingAddress#field-MailingAddress.fields.country)

The customer's country.

***

country\_code

**read-only**

->[countryCodeV2](https://shopify.dev/docs/api/admin-graphql/latest/objects/MailingAddress#field-MailingAddress.fields.countryCodeV2)

The two-letter country code corresponding to the customer's country.

***

country\_name

->[country](https://shopify.dev/docs/api/admin-graphql/latest/objects/MailingAddress#field-MailingAddress.fields.country)

The customer’s normalized country name.

***

company

->[company](https://shopify.dev/docs/api/admin-graphql/latest/objects/MailingAddress#field-MailingAddress.fields.company)

The customer’s company.

***

customer\_id

**deprecated**

The unique identifier for the customer.

***

first\_name

->[firstName](https://shopify.dev/docs/api/admin-graphql/latest/objects/MailingAddress#field-MailingAddress.fields.firstName)

The customer’s first name.

***

id

**read-only**

->[id](https://shopify.dev/docs/api/admin-graphql/latest/objects/MailingAddress#field-MailingAddress.fields.id)

The unique identifier for the address.

***

last\_name

->[lastName](https://shopify.dev/docs/api/admin-graphql/latest/objects/MailingAddress#field-MailingAddress.fields.lastName)

The customer’s last name.

***

name

->[name](https://shopify.dev/docs/api/admin-graphql/latest/objects/MailingAddress#field-MailingAddress.fields.name)

The customer’s first and last names.

***

{}

## The Customer Address resource

```json
{
  "address1": "1 Rue des Carrieres",
  "address2": "Suite 1234",
  "city": "Montreal",
  "country": "Canada",
  "country_code": "CA",
  "country_name": "Canada",
  "company": "Fancy Co.",
  "customer_id": {
    "id": 1073339470
  },
  "first_name": "Samuel",
  "id": 207119551,
  "last_name": "de Champlain",
  "name": "Samuel de Champlain",
  "phone": "819-555-5555",
  "province": "Quebec",
  "province_code": "QC",
  "zip": "G1R 4P5"
}
```

***

## postCreates a new address for a customer

[customerUpdate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerUpdate?example=creates-a-new-address-for-a-customer)

Creates a new address for a customer.

### Parameters

***

api\_version

**string**

**required**

***

customer\_id

**string**

**required**

***

### Examples

### Create a new address for a customer

### Path parameters

customer\_​id=​207119551

**string**

**required**

post

## /admin/api/2026-07/customers/207119551/addresses.​json

```bash
curl -d '{"address":{"address1":"1 Rue des Carrieres","address2":"Suite 1234","city":"Montreal","company":"Fancy Co.","first_name":"Samuel","last_name":"de Champlain","phone":"819-555-5555","province":"Quebec","country":"Canada","zip":"G1R 4P5","province_code":"QC","country_code":"CA","country_name":"Canada"}}' \
-X POST "https://your-development-store.myshopify.com/admin/api/2026-07/customers/207119551/addresses.json" \
-H "X-Shopify-Access-Token: {access_token}" \
-H "Content-Type: application/json"
```

{}

## Response

JSON

```json
HTTP/1.1 201 Created
{
  "customer_address": {
    "id": 1053317310,
    "customer_id": 207119551,
    "first_name": "Samuel",
    "last_name": "de Champlain",
    "company": "Fancy Co.",
    "address1": "1 Rue des Carrieres",
    "address2": "Suite 1234",
    "city": "Montreal",
    "province": "Quebec",
    "country": "Canada",
    "zip": "G1R 4P5",
    "phone": "+18195555555",
    "name": "Samuel de Champlain",
    "province_code": "QC",
    "country_code": "CA",
    "country_name": "Canada",
    "default": false
  }
}
```

### examples

* #### Create a new address for a customer

  #####

  ```curl
  curl -d '{"address":{"address1":"1 Rue des Carrieres","address2":"Suite 1234","city":"Montreal","company":"Fancy Co.","first_name":"Samuel","last_name":"de Champlain","phone":"819-555-5555","province":"Quebec","country":"Canada","zip":"G1R 4P5","province_code":"QC","country_code":"CA","country_name":"Canada"}}' \
  -X POST "https://your-development-store.myshopify.com/admin/api/2026-07/customers/207119551/addresses.json" \
  -H "X-Shopify-Access-Token: {access_token}" \
  -H "Content-Type: application/json"
  ```

  #### response

  ```json
  HTTP/1.1 201 Created{"customer_address":{"id":1053317310,"customer_id":207119551,"first_name":"Samuel","last_name":"de Champlain","company":"Fancy Co.","address1":"1 Rue des Carrieres","address2":"Suite 1234","city":"Montreal","province":"Quebec","country":"Canada","zip":"G1R 4P5","phone":"+18195555555","name":"Samuel de Champlain","province_code":"QC","country_code":"CA","country_name":"Canada","default":false}}
  ```

***

## getRetrieves a list of addresses for a customer

[customer](https://shopify.dev/docs/api/admin-graphql/latest/queries/customer?example=retrieves-a-list-of-addresses-for-a-customer)

Retrieves a list of addresses for a customer. **Note:** This endpoint implements pagination by using links that are provided in the response header. To learn more, refer to [Make paginated requests to the REST Admin API](https://shopify.dev/api/usage/pagination-rest).

### Parameters

***

api\_version

**string**

**required**

***

customer\_id

**string**

**required**

***

### Examples

### Retrieve a limited number of addresses for a customer

### Query parameters

### Retrieve all of a customer’s addresses

get

## /admin/api/2026-07/customers/207119551/addresses.​json?limit=​1

```bash
curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/customers/207119551/addresses.json?limit=1" \
-H "X-Shopify-Access-Token: {access_token}"
```

{}

## Response

JSON

```json
HTTP/1.1 200 OK
{
  "addresses": [
    {
      "id": 207119551,
      "customer_id": 207119551,
      "first_name": null,
      "last_name": null,
      "company": null,
      "address1": "Chestnut Street 92",
      "address2": "",
      "city": "Louisville",
      "province": "Kentucky",
      "country": "United States",
      "zip": "40202",
      "phone": "555-625-1199",
      "name": "",
      "province_code": "KY",
      "country_code": "US",
      "country_name": "United States",
      "default": true
    }
  ]
}
```

### examples

* #### Retrieve a limited number of addresses for a customer

  #####

  ```curl
  curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/customers/207119551/addresses.json?limit=1" \
  -H "X-Shopify-Access-Token: {access_token}"
  ```

  #### response

  ```json
  HTTP/1.1 200 OK{"addresses":[{"id":207119551,"customer_id":207119551,"first_name":null,"last_name":null,"company":null,"address1":"Chestnut Street 92","address2":"","city":"Louisville","province":"Kentucky","country":"United States","zip":"40202","phone":"555-625-1199","name":"","province_code":"KY","country_code":"US","country_name":"United States","default":true}]}
  ```

* #### Retrieve all of a customer’s addresses

  #####

  ```curl
  curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/customers/207119551/addresses.json" \
  -H "X-Shopify-Access-Token: {access_token}"
  ```

***

## getRetrieves details for a single customer address

[customer](https://shopify.dev/docs/api/admin-graphql/latest/queries/customer)

Retrieves details for a single customer address.

### Parameters

***

address\_id

**string**

**required**

***

api\_version

**string**

**required**

***

customer\_id

**string**

**required**

***

### Examples

### Retrieve a single customer address

get

## /admin/api/2026-07/customers/207119551/addresses/207119551.​json

```bash
curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/customers/207119551/addresses/207119551.json" \
-H "X-Shopify-Access-Token: {access_token}"
```

{}

## Response

JSON

```json
HTTP/1.1 200 OK
{
  "customer_address": {
    "id": 207119551,
    "customer_id": 207119551,
    "first_name": null,
    "last_name": null,
    "company": null,
    "address1": "Chestnut Street 92",
    "address2": "",
    "city": "Louisville",
    "province": "Kentucky",
    "country": "United States",
    "zip": "40202",
    "phone": "555-625-1199",
    "name": "",
    "province_code": "KY",
    "country_code": "US",
    "country_name": "United States",
    "default": true
  }
}
```

### examples

* #### Retrieve a single customer address

  #####

  ```curl
  curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/customers/207119551/addresses/207119551.json" \
  -H "X-Shopify-Access-Token: {access_token}"
  ```

  #### response

  ```json
  HTTP/1.1 200 OK{"customer_address":{"id":207119551,"customer_id":207119551,"first_name":null,"last_name":null,"company":null,"address1":"Chestnut Street 92","address2":"","city":"Louisville","province":"Kentucky","country":"United States","zip":"40202","phone":"555-625-1199","name":"","province_code":"KY","country_code":"US","country_name":"United States","default":true}}
  ```

***

## putUpdates an existing customer address

[customerUpdateDefaultAddress](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerUpdateDefaultAddress?example=updates-an-existing-customer-address)

Updates an existing customer address.

### Parameters

***

address\_id

**string**

**required**

***

api\_version

**string**

**required**

***

customer\_id

**string**

**required**

***

### Examples

### Update the postal code of a customer address

### Update the street address of a customer address

put

## /admin/api/2026-07/customers/207119551/addresses/207119551.​json

```bash
curl -d '{"address":{"id":207119551,"zip":"90210"}}' \
-X PUT "https://your-development-store.myshopify.com/admin/api/2026-07/customers/207119551/addresses/207119551.json" \
-H "X-Shopify-Access-Token: {access_token}" \
-H "Content-Type: application/json"
```

{}

## Response

JSON

```json
HTTP/1.1 200 OK
{
  "customer_address": {
    "id": 207119551,
    "customer_id": 207119551,
    "first_name": null,
    "last_name": null,
    "company": null,
    "address1": "Chestnut Street 92",
    "address2": null,
    "city": "Louisville",
    "province": "Kentucky",
    "country": "United States",
    "zip": "90210",
    "phone": "555-625-1199",
    "name": "",
    "province_code": "KY",
    "country_code": "US",
    "country_name": "United States",
    "default": true
  }
}
```

### examples

* #### Update the postal code of a customer address

  #####

  ```curl
  curl -d '{"address":{"id":207119551,"zip":"90210"}}' \
  -X PUT "https://your-development-store.myshopify.com/admin/api/2026-07/customers/207119551/addresses/207119551.json" \
  -H "X-Shopify-Access-Token: {access_token}" \
  -H "Content-Type: application/json"
  ```

  #### response

  ```json
  HTTP/1.1 200 OK{"customer_address":{"id":207119551,"customer_id":207119551,"first_name":null,"last_name":null,"company":null,"address1":"Chestnut Street 92","address2":null,"city":"Louisville","province":"Kentucky","country":"United States","zip":"90210","phone":"555-625-1199","name":"","province_code":"KY","country_code":"US","country_name":"United States","default":true}}
  ```

* #### Update the street address of a customer address

  #####

  ```curl
  curl -d '{"address":{"id":207119551,"address1":"Apartment 23","address2":"Chestnut Street 92"}}' \
  -X PUT "https://your-development-store.myshopify.com/admin/api/2026-07/customers/207119551/addresses/207119551.json" \
  -H "X-Shopify-Access-Token: {access_token}" \
  -H "Content-Type: application/json"
  ```

***

## putSets the default address for a customer

[customerUpdateDefaultAddress](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerUpdateDefaultAddress?example=sets-the-default-address-for-a-customer)

Sets the default address for a customer.

### Parameters

***

address\_id

**string**

**required**

***

api\_version

**string**

**required**

***

customer\_id

**string**

**required**

***

### Examples

### Set a default address for a customer

put

## /admin/api/2026-07/customers/207119551/addresses/1053317308/default.​json

```bash
curl -X PUT "https://your-development-store.myshopify.com/admin/api/2026-07/customers/207119551/addresses/1053317308/default.json" \
-H "X-Shopify-Access-Token: {access_token}"
```

{}

## Response

JSON

```json
HTTP/1.1 200 OK
{
  "customer_address": {
    "id": 1053317308,
    "customer_id": 207119551,
    "first_name": null,
    "last_name": null,
    "company": null,
    "address1": "123 Test St",
    "address2": null,
    "city": "Ottawa",
    "province": "Ontario",
    "country": "Canada",
    "zip": null,
    "phone": null,
    "name": "",
    "province_code": "ON",
    "country_code": "CA",
    "country_name": "Canada",
    "default": false
  }
}
```

### examples

* #### Set a default address for a customer

  #####

  ```curl
  curl -X PUT "https://your-development-store.myshopify.com/admin/api/2026-07/customers/207119551/addresses/1053317308/default.json" \
  -H "X-Shopify-Access-Token: {access_token}"
  ```

  #### response

  ```json
  HTTP/1.1 200 OK{"customer_address":{"id":1053317308,"customer_id":207119551,"first_name":null,"last_name":null,"company":null,"address1":"123 Test St","address2":null,"city":"Ottawa","province":"Ontario","country":"Canada","zip":null,"phone":null,"name":"","province_code":"ON","country_code":"CA","country_name":"Canada","default":false}}
  ```

***

## putPerforms bulk operations for multiple customer addresses

[customerUpdate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerUpdate?example=performs-bulk-operations-for-multiple-customer-addresses)

Performs bulk operations for multiple customer addresses.

### Parameters

***

address\_ids\[]

**required**

Performs bulk operations on a list of customer address IDs. Format: `address_ids[]=1&address_ids[]=2&address_ids[]=3`.

***

api\_version

**string**

**required**

***

customer\_id

**string**

**required**

***

operation

**required**

Operation to perform by keyword (for example, destroy)

***

### Examples

### Destroy multiple customer addresses

### Query parameters

address\_​ids\[]=​1053317309

**required**

Performs bulk operations on a list of customer address IDs. Format: `address_ids[]=1&address_ids[]=2&address_ids[]=3`.

operation=​destroy

**required**

Operation to perform by keyword (for example, destroy)

put

## /admin/api/2026-07/customers/207119551/addresses/set.​json?address\_​ids\[]=​1053317309\&operation=​destroy

```bash
curl -X PUT "https://your-development-store.myshopify.com/admin/api/2026-07/customers/207119551/addresses/set.json?address_ids%5B%5D=1053317309&operation=destroy" \
-H "X-Shopify-Access-Token: {access_token}"
```

{}

## Response

JSON

```json
HTTP/1.1 200 OK
{}
```

### examples

* #### Destroy multiple customer addresses

  #####

  ```curl
  curl -X PUT "https://your-development-store.myshopify.com/admin/api/2026-07/customers/207119551/addresses/set.json?address_ids%5B%5D=1053317309&operation=destroy" \
  -H "X-Shopify-Access-Token: {access_token}"
  ```

  #### response

  ```json
  HTTP/1.1 200 OK{}
  ```

***

## delRemoves an address from a customer’s address list

Removes an address from a customer’s address list.

### Parameters

***

address\_id

**string**

**required**

***

api\_version

**string**

**required**

***

customer\_id

**string**

**required**

***

### Examples

### Remove a customer address

### Removing a customer’s default address fails and returns an error

del

## /admin/api/2026-07/customers/207119551/addresses/1053317307.​json

```bash
curl -X DELETE "https://your-development-store.myshopify.com/admin/api/2026-07/customers/207119551/addresses/1053317307.json" \
-H "X-Shopify-Access-Token: {access_token}"
```

{}

## Response

JSON

```json
HTTP/1.1 200 OK
{}
```

### examples

* #### Remove a customer address

  #####

  ```curl
  curl -X DELETE "https://your-development-store.myshopify.com/admin/api/2026-07/customers/207119551/addresses/1053317307.json" \
  -H "X-Shopify-Access-Token: {access_token}"
  ```

  #### response

  ```json
  HTTP/1.1 200 OK{}
  ```

* #### Removing a customer’s default address fails and returns an error

  #####

  ```curl
  curl -X DELETE "https://your-development-store.myshopify.com/admin/api/2026-07/customers/207119551/addresses/207119551.json" \
  -H "X-Shopify-Access-Token: {access_token}"
  ```

  #### response

  ```json
  HTTP/1.1 422 Unprocessable Entity{"errors":{"base":["Cannot delete the customer’s default address"]}}
  ```