Shopify

Shopify Addresses API

The Addresses API from Shopify — 12 operation(s) for addresses.

Documentation GitHub OpenAPI

Business capability

Operations 12

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /admin/api/2020-01/customers/{customer_id}/addresses.json List a customer's addresses (API 2020-01) · Shopify Retrieves A List Of Addresses For A Customer #

Ask an LLM

“How can I see every shipping and billing address saved for a customer on the 2020-01 API?”

“Can version 2020-01 show all the addresses in one customer's address book?”

Tell an agent

List the addresses for customer {customer_id} using version 2020-01.

Show me customer {customer_id}'s saved addresses on 2020-01.

PUT /admin/api/2020-01/customers/{customer_id}/addresses/set.json Bulk-change a customer's addresses (API 2020-01) · Shopify Performs Bulk Operations For Multiple Customer Addresses #

Ask an LLM

“Can I remove several of a customer's saved addresses in one call on the 2020-01 API?”

“Which inputs does the 2020-01 bulk address operation take?”

Tell an agent destructive · confirm first

Run bulk operation {operation} on addresses {address_ids} of customer {customer_id} using 2020-01.

On version 2020-01, apply {operation} to several addresses of customer {customer_id} at once.

GET /admin/api/2020-04/customers/{customer_id}/addresses.json List a customer's addresses (API 2020-04) · Shopify Retrieves A List Of Addresses For A Customer #

Ask an LLM

“What addresses does a customer have on file, per API version 2020-04?”

“Is there a 2020-04 call returning a customer's full address book?”

Tell an agent

Retrieve customer {customer_id}'s address list from the 2020-04 Admin API.

On 2020-04, pull every saved address for {customer_id}.

PUT /admin/api/2020-04/customers/{customer_id}/addresses/set.json Bulk-change a customer's addresses (API 2020-04) · Shopify Performs Bulk Operations For Multiple Customer Addresses #

Ask an LLM

“Is it possible to clean up a batch of a customer's old addresses together on 2020-04?”

“What does the 2020-04 addresses set endpoint expect for the address IDs?”

Tell an agent destructive · confirm first

Apply {operation} in bulk to addresses {address_ids} for {customer_id} through the 2020-04 Admin API.

On 2020-04, batch-process address IDs {address_ids} belonging to customer {customer_id}.

GET /admin/api/2020-07/customers/{customer_id}/addresses.json List a customer's addresses (API 2020-07) · Shopify Retrieves A List Of Addresses For A Customer #

Ask an LLM

“Using the 2020-07 release, where do I read all of a customer's addresses?”

“Does 2020-07 list every delivery address a shopper saved?”

Tell an agent

Fetch the address book of customer {customer_id} via 2020-07.

Enumerate {customer_id}'s addresses on the 2020-07 release.

PUT /admin/api/2020-07/customers/{customer_id}/addresses/set.json Bulk-change a customer's addresses (API 2020-07) · Shopify Performs Bulk Operations For Multiple Customer Addresses #

Ask an LLM

“Using the 2020-07 release, can I act on many customer addresses in a single request?”

“Does 2020-07 support bulk operations over a customer's address IDs?”

Tell an agent destructive · confirm first

Perform {operation} on customer {customer_id}'s addresses {address_ids} via 2020-07.

Bulk-update the address set of {customer_id} on the 2020-07 release.

GET /admin/api/2020-10/customers/{customer_id}/addresses.json List a customer's addresses (current 2020-10) · Shopify Retrieves A List Of Addresses For A Customer #

Ask an LLM

“Which call lists a customer's addresses on the current 2020-10 version?”

“Can I get all the addresses on a customer account from the non-deprecated API?”

Tell an agent

List addresses for customer {customer_id} with the non-deprecated 2020-10 API.

Using 2020-10, show every address saved on {customer_id}'s account.

PUT /admin/api/2020-10/customers/{customer_id}/addresses/set.json Bulk-change a customer's addresses (current 2020-10) · Shopify Performs Bulk Operations For Multiple Customer Addresses #

Ask an LLM

“Which call performs a bulk operation on a customer's addresses on the current 2020-10 version?”

“Can the non-deprecated API delete a batch of a customer's stale addresses?”

Tell an agent destructive · confirm first

Run {operation} across addresses {address_ids} of customer {customer_id} with the non-deprecated 2020-10 API.

Using 2020-10, bulk-apply {operation} to customer {customer_id}'s address set.

GET /admin/api/2021-01/customers/{customer_id}/addresses.json List a customer's addresses (API 2021-01) · Shopify Retrieves A List Of Addresses For A Customer #

Ask an LLM

“Can I still list a customer's addresses on the deprecated 2021-01 version?”

“What does the 2021-01 customer address list return?”

Tell an agent

Return all addresses of customer {customer_id} from API version 2021-01.

Show {customer_id}'s address book via 2021-01.

PUT /admin/api/2021-01/customers/{customer_id}/addresses/set.json Bulk-change a customer's addresses (API 2021-01) · Shopify Performs Bulk Operations For Multiple Customer Addresses #

Ask an LLM

“Can I still run bulk address operations for a customer on the deprecated 2021-01 version?”

“What happens to a customer's addresses when I call the 2021-01 set endpoint?”

Tell an agent destructive · confirm first

Execute {operation} on addresses {address_ids} of {customer_id} through API version 2021-01.

Bulk-process customer {customer_id}'s address IDs {address_ids} via 2021-01.

GET /admin/api/unstable/customers/{customer_id}/addresses.json List a customer's addresses (unstable API) · Shopify Retrieves A List Of Addresses For A Customer #

Ask an LLM

“How can I list a customer's addresses on the unstable Admin API?”

“Is the customer address list available in the unstable version?”

Tell an agent

List addresses of customer {customer_id} on the unstable version.

Show the unstable-version address book for {customer_id}.

PUT /admin/api/unstable/customers/{customer_id}/addresses/set.json Bulk-change a customer's addresses (unstable API) · Shopify Performs Bulk Operations For Multiple Customer Addresses #

Ask an LLM

“How can I bulk-modify a customer's addresses against the unstable Admin API?”

“Is the bulk address set operation supported in the unstable version?”

Tell an agent destructive · confirm first

Apply {operation} to addresses {address_ids} of customer {customer_id} on the unstable version.

Run the unstable-version bulk address operation for {customer_id}.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/shopify:shopify-addresses-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Shopify Addresses API
  description: Explore Shopify's API reference and templating documentation. Shopify provides a range of software tools, app templates, example apps, and libraries to accelerate your development process. The Admin API lets you build apps and integrations that extend and enhance the Shopify admin.
  version: 2020-10
tags:
- name: Addresses
paths:
  /admin/api/2020-01/customers/{customer_id}/addresses.json:
    get:
      summary: Shopify Retrieves A List Of Addresses For A Customer
      description: https://shopify.dev/docs/admin-api/rest/reference/customers/customer-address#index-2020-01
      parameters:
      - in: path
        name: customer_id
        required: true
        schema:
          type: string
        description: customer_id
      tags:
      - Addresses
      responses:
        '200':
          description: ''
      operationId: deprecated_202001_get_customers_param_customer_id_addresses
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-01/customers/{customer_id}/addresses/set.json:
    put:
      summary: Shopify Performs Bulk Operations For Multiple Customer Addresses
      description: https://shopify.dev/docs/admin-api/rest/reference/customers/customer-address#set-2020-01
      parameters:
      - in: path
        name: customer_id
        required: true
        schema:
          type: string
        description: customer_id
      - in: query
        name: address_ids[]
        schema:
          type: integer
        description: address_ids[]
        required: false
      - in: query
        name: operation
        schema:
          type: string
        description: operation
        required: false
      tags:
      - Addresses
      responses:
        '200':
          description: ''
      operationId: deprecated_202001_update_customers_param_customer_id_addresses_set
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-04/customers/{customer_id}/addresses.json:
    get:
      summary: Shopify Retrieves A List Of Addresses For A Customer
      description: https://shopify.dev/docs/admin-api/rest/reference/customers/customer-address#index-2020-04
      parameters:
      - in: path
        name: customer_id
        required: true
        schema:
          type: string
        description: customer_id
      tags:
      - Addresses
      responses:
        '200':
          description: ''
      operationId: deprecated_202004_get_customers_param_customer_id_addresses
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-04/customers/{customer_id}/addresses/set.json:
    put:
      summary: Shopify Performs Bulk Operations For Multiple Customer Addresses
      description: https://shopify.dev/docs/admin-api/rest/reference/customers/customer-address#set-2020-04
      parameters:
      - in: path
        name: customer_id
        required: true
        schema:
          type: string
        description: customer_id
      - in: query
        name: address_ids[]
        schema:
          type: integer
        description: address_ids[]
        required: false
      - in: query
        name: operation
        schema:
          type: string
        description: operation
        required: false
      tags:
      - Addresses
      responses:
        '200':
          description: ''
      operationId: deprecated_202004_update_customers_param_customer_id_addresses_set
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-07/customers/{customer_id}/addresses.json:
    get:
      summary: Shopify Retrieves A List Of Addresses For A Customer
      description: https://shopify.dev/docs/admin-api/rest/reference/customers/customer-address#index-2020-07
      parameters:
      - in: path
        name: customer_id
        required: true
        schema:
          type: string
        description: customer_id
      tags:
      - Addresses
      responses:
        '200':
          description: ''
      operationId: deprecated_202007_get_customers_param_customer_id_addresses
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-07/customers/{customer_id}/addresses/set.json:
    put:
      summary: Shopify Performs Bulk Operations For Multiple Customer Addresses
      description: https://shopify.dev/docs/admin-api/rest/reference/customers/customer-address#set-2020-07
      parameters:
      - in: path
        name: customer_id
        required: true
        schema:
          type: string
        description: customer_id
      - in: query
        name: address_ids[]
        schema:
          type: integer
        description: address_ids[]
        required: false
      - in: query
        name: operation
        schema:
          type: string
        description: operation
        required: false
      tags:
      - Addresses
      responses:
        '200':
          description: ''
      operationId: deprecated_202007_update_customers_param_customer_id_addresses_set
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-10/customers/{customer_id}/addresses.json:
    get:
      summary: Shopify Retrieves A List Of Addresses For A Customer
      description: https://shopify.dev/docs/admin-api/rest/reference/customers/customer-address#index-2020-10
      parameters:
      - in: path
        name: customer_id
        required: true
        schema:
          type: string
        description: customer_id
      tags:
      - Addresses
      responses:
        '200':
          description: ''
      operationId: get_customers_param_customer_id_addresses
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-10/customers/{customer_id}/addresses/set.json:
    put:
      summary: Shopify Performs Bulk Operations For Multiple Customer Addresses
      description: https://shopify.dev/docs/admin-api/rest/reference/customers/customer-address#set-2020-10
      parameters:
      - in: path
        name: customer_id
        required: true
        schema:
          type: string
        description: customer_id
      - in: query
        name: address_ids[]
        schema:
          type: integer
        description: address_ids[]
        required: false
      - in: query
        name: operation
        schema:
          type: string
        description: operation
        required: false
      tags:
      - Addresses
      responses:
        '200':
          description: ''
      operationId: update_customers_param_customer_id_addresses_set
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2021-01/customers/{customer_id}/addresses.json:
    get:
      summary: Shopify Retrieves A List Of Addresses For A Customer
      description: https://shopify.dev/docs/admin-api/rest/reference/customers/customer-address#index-2021-01
      parameters:
      - in: path
        name: customer_id
        required: true
        schema:
          type: string
        description: customer_id
      tags:
      - Addresses
      responses:
        '200':
          description: ''
      operationId: deprecated_202101_get_customers_param_customer_id_addresses
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2021-01/customers/{customer_id}/addresses/set.json:
    put:
      summary: Shopify Performs Bulk Operations For Multiple Customer Addresses
      description: https://shopify.dev/docs/admin-api/rest/reference/customers/customer-address#set-2021-01
      parameters:
      - in: path
        name: customer_id
        required: true
        schema:
          type: string
        description: customer_id
      - in: query
        name: address_ids[]
        schema:
          type: integer
        description: address_ids[]
        required: false
      - in: query
        name: operation
        schema:
          type: string
        description: operation
        required: false
      tags:
      - Addresses
      responses:
        '200':
          description: ''
      operationId: deprecated_202101_update_customers_param_customer_id_addresses_set
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/unstable/customers/{customer_id}/addresses.json:
    get:
      summary: Shopify Retrieves A List Of Addresses For A Customer
      description: https://shopify.dev/docs/admin-api/rest/reference/customers/customer-address#index-unstable
      parameters:
      - in: path
        name: customer_id
        required: true
        schema:
          type: string
        description: customer_id
      tags:
      - Addresses
      responses:
        '200':
          description: ''
      operationId: deprecated_unstable_get_customers_param_customer_id_addresses
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/unstable/customers/{customer_id}/addresses/set.json:
    put:
      summary: Shopify Performs Bulk Operations For Multiple Customer Addresses
      description: https://shopify.dev/docs/admin-api/rest/reference/customers/customer-address#set-unstable
      parameters:
      - in: path
        name: customer_id
        required: true
        schema:
          type: string
        description: customer_id
      - in: query
        name: address_ids[]
        schema:
          type: integer
        description: address_ids[]
        required: false
      - in: query
        name: operation
        schema:
          type: string
        description: operation
        required: false
      tags:
      - Addresses
      responses:
        '200':
          description: ''
      operationId: deprecated_unstable_update_customers_param_customer_id_addresses_set
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true

Shopify Addresses API

Operations 12

Documentation

Specifications

Schemas & Data

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification