---
title: "List stores"
method: GET
path: "/3.0/ecommerce/stores"
tags: ["ecommerce"]
---

# List stores

`GET /3.0/ecommerce/stores`

## Request

- Base URL: `https://api.mailchimp.com`
- URL: `https://api.mailchimp.com/3.0/ecommerce/stores`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://login.mailchimp.com/oauth2/authorize`
    - Token URL: `https://login.mailchimp.com/oauth2/token`
- TypeScript: <https://skmtc.dev/mailchimp/apis/mailchimp-api/docs/3.0/ecommerce/stores/get.ts> (a function with typed inputs; its response is checked against the schema)

Get information about all stores in the account.

## Query parameters

- `fields` string[]
- `exclude_fields` string[]
- `count` integer
- `offset` integer

## Response `200`

- object: A collection of stores in the account.
  - `_links` object[]: A list of link types and descriptions for the API schema documents.
    - `href` string: This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action.
    - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD': The HTTP method that should be used when accessing the URL defined in 'href'.
    - `rel` string: As with an HTML 'rel' attribute, this describes the type of link.
    - `schema` string: For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to.
    - `targetSchema` string: For GETs, this is a URL representing the schema that the response should conform to.
  - `stores` object[]: An array of objects, each representing a store.
    - `_links` object[]: A list of link types and descriptions for the API schema documents.
      - `href` string: This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action.
      - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD': The HTTP method that should be used when accessing the URL defined in 'href'.
      - `rel` string: As with an HTML 'rel' attribute, this describes the type of link.
      - `schema` string: For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to.
      - `targetSchema` string: For GETs, this is a URL representing the schema that the response should conform to.
    - `address` object: The store address.
      - `address1` string: The store's mailing address.
      - `address2` string: An additional field for the store's mailing address.
      - `city` string: The city the store is located in.
      - `country` string: The store's country.
      - `country_code` string: The two-letter code for to the store's country.
      - `latitude` number: The latitude of the store location.
      - `longitude` number: The longitude of the store location.
      - `postal_code` string: The store's postal or zip code.
      - `province` string: The store's state name or normalized province.
      - `province_code` string: The two-letter code for the store's province or state.
    - `automations` object: Details for the automations attached to this store.
      - `abandoned_browse` object: abandonedBrowse automation details. abandonedBrowse is also known as Product Retargeting Email or Retarget Site Visitors on the web.
        - `id` string: Unique ID of automation parent campaign.
        - `is_supported` boolean: Whether this store supports the abandonedBrowse automation.
        - `status` 'save' | 'sending' | 'paused': Status of the abandonedBrowse automation.
      - `abandoned_cart` object: abandonedCart automation details.
        - `id` string: Unique ID of automation parent campaign.
        - `is_supported` boolean: Whether this store supports the abandonedCart automation.
        - `status` 'save' | 'sending' | 'paused': Status of the abandonedCart automation.
    - `connected_site` object: The Connected Site associated with the store.
      - `site_foreign_id` string: The unique identifier for the connected site.
      - `site_script` object: The script used to connect your site with Mailchimp.
        - `fragment` string: A pre-built script that you can copy-and-paste into your site to integrate it with Mailchimp.
        - `url` string: The URL used for any integrations that offer built-in support for connected sites.
    - `created_at` string, date-time: The date and time the store was created in ISO 8601 format.
    - `currency_code` string: The three-letter ISO 4217 code for the currency that the store accepts.
    - `domain` string: The store domain. The store domain must be unique within a user account.
    - `email_address` string: The email address for the store.
    - `id` string: The unique identifier for the store.
    - `is_syncing` boolean: Whether to disable automations because the store is currently [syncing](https://mailchimp.com/developer/marketing/docs/e-commerce/#pausing-store-automations).
    - `list_id` string: The unique identifier for the list that's associated with the store. The `list_id` for a specific store can't change.
    - `list_is_active` boolean: The status of the list connected to the store, namely if it's deleted or disabled.
    - `money_format` string: The currency format for the store. For example: `$`, `£`, etc.
    - `name` string: The name of the store.
    - `phone` string: The store phone number.
    - `platform` string: The e-commerce platform of the store.
    - `primary_locale` string: The primary locale for the store. For example: `en`, `de`, etc.
    - `timezone` string: The timezone for the store.
    - `updated_at` string, date-time: The date and time the store was last updated in ISO 8601 format.
  - `total_items` integer: The total number of items matching the query regardless of pagination.

## Other responses

- `default`: An error generated by the Mailchimp API.

---

[API](https://skmtc.dev/mailchimp/apis/mailchimp-api.md) - [All operations](https://skmtc.dev/mailchimp/apis/mailchimp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mailchimp/apis/mailchimp-api/revisions/53bf4b156855?raw)