---
title: shop - Customer API
description: >-
  Returns the information about the shop. Apps using the Customer Account API
  must meet the protected customer data
  [requirements](https://shopify.dev/docs/apps/launch/protected-customer-data).
api_version: unstable
api_name: customer
source_url:
  html: 'https://shopify.dev/docs/api/customer/unstable/queries/shop'
  md: 'https://shopify.dev/docs/api/customer/unstable/queries/shop.md'
---

# shop

query

Returns the information about the shop. Apps using the Customer Account API must meet the protected customer data [requirements](https://shopify.dev/docs/apps/launch/protected-customer-data).

## Possible returns

* Shop

  [Shop!](https://shopify.dev/docs/api/customer/unstable/objects/Shop)

  A collection of the general information about the shop.

  * email

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

    non-null

    The email of the shop.

  * id

    [ID!](https://shopify.dev/docs/api/customer/unstable/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.

  * metafield

    [Metafield](https://shopify.dev/docs/api/customer/unstable/objects/Metafield)

    [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

    A metafield found by namespace and key.

    * namespace

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

      required

      ### Arguments

      A container for a set of metafields.

    * key

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

      required

      The identifier for the metafield.

    ***

  * metafields

    [\[Metafield\]!](https://shopify.dev/docs/api/customer/unstable/objects/Metafield)

    non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

    The metafields associated with the resource matching the supplied list of namespaces and keys.

    * identifiers

      [\[Has​Metafields​Identifier!\]!](https://shopify.dev/docs/api/customer/unstable/input-objects/HasMetafieldsIdentifier)

      required

      ### Arguments

      The list of metafields to retrieve by namespace and key.

    ***

  * myshopify​Domain

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

    non-null

    The shop's .myshopify.com domain name.

  * name

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

    non-null

    The name of the shop.

  * return​Reason​Definitions

    [Return​Reason​Definition​Connection!](https://shopify.dev/docs/api/customer/unstable/connections/ReturnReasonDefinitionConnection)

    non-null

    Returns the full library of available return reason definitions.

    * ids

      [\[ID!\]](https://shopify.dev/docs/api/customer/unstable/scalars/ID)

      ### Arguments

      A list of return reason definition IDs to filter by.

    * handles

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

      A list of return reason definition handles to filter by.

    * first

      [Int](https://shopify.dev/docs/api/customer/unstable/scalars/Int)

      The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

    * after

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

      The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

    * last

      [Int](https://shopify.dev/docs/api/customer/unstable/scalars/Int)

      The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

    * before

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

      The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

    * reverse

      [Boolean](https://shopify.dev/docs/api/customer/unstable/scalars/Boolean)

      Default:false

      Reverse the order of the underlying list.

    * sort​Key

      [Return​Reason​Definition​Sort​Keys](https://shopify.dev/docs/api/customer/unstable/enums/ReturnReasonDefinitionSortKeys)

      Default:ID

      Sort the underlying list using a key. If your query is slow or returns an error, then [try specifying a sort key that matches the field used in the search](https://shopify.dev/api/usage/pagination-graphql#search-performance-considerations).

    * query

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

      A filter made up of terms, connectives, modifiers, and comparators. You can apply one or more filters to a query. Learn more about [Shopify API search syntax](https://shopify.dev/api/usage/search-syntax).

      * * default

          string

        * deleted

          boolean

        - Filter by a case-insensitive search of multiple fields in a document.

        - Example:

          * `query=Bob Norman`
          * `query=title:green hoodie`

          Filter by whether the return reason has been removed from taxonomy.

      * * id

          id

        * name

          string

        - Filter by `id` range.

        - Example:

          * `id:1234`
          * `id:>=1234`
          * `id:<=1234`

          Filter by name.

    ***

  * shop​Policies

    [\[Shop​Policy!\]!](https://shopify.dev/docs/api/customer/unstable/objects/ShopPolicy)

    non-null

    The list of all legal policies associated with the shop.

  * url

    [URL!](https://shopify.dev/docs/api/customer/unstable/scalars/URL)

    non-null

    The URL of the shop's online store.

***

## Examples

* ### shop reference

## Query Reference

```graphql
{
  shop {
    # shop fields
  }
}
```