---
title: "shop"
description: >
  Query a store's information, including the store ID,  store name, currency, and other details.
doc_type: graphql
doc_category: adminGraphQL
doc_version: v20260901
source_url:
  html: 'https://developer.shopline.com/docs/admin-graph-ql-api/store-properties/queries/shop'
  md: 'https://developer.shopline.com/docs/admin-graph-ql-api/store-properties/queries/shop.md'
---
# shop

Query a store's information, including the store ID,  store name, currency, and other details.

- **API Version:** v20260901
- **API Type:** Admin
- **API Protocol:** GraphQL
- **Operation Type:** Query

## Returns

* `contactEmail`

  [String!](https://developer.shopline.com/docs/admin-graph-ql-api/common/scalars/string.md)

  The merchant's email address for customer communication.

* `name`

  [String!](https://developer.shopline.com/docs/admin-graph-ql-api/common/scalars/string.md)

  Store name.

* `handle`

  [String!](https://developer.shopline.com/docs/admin-graph-ql-api/common/scalars/string.md)

  The store's unique identifier, which is the prefix of the store's domain name. For example, if a store's domain name is `open001.myshopline.com`, the store handle is `open001`.

* `id`

  [ID!](https://developer.shopline.com/docs/admin-graph-ql-api/common/scalars/id.md)

  Store's unique ID.

* `currencyCode`

  [CurrencyCode!](https://developer.shopline.com/docs/admin-graph-ql-api/common-objects/enums/currency-code.md)

  The settlement currency used by the buyer when placing orders in the store. The value of this parameter is a three-letter currency code that follows the [`ISO 4217`](https://en.wikipedia.org/wiki/ISO_4217) standard. For example, `USD`.

* `ianaTimezone`

  [String!](https://developer.shopline.com/docs/admin-graph-ql-api/common/scalars/string.md)

  The time zone set for the store.

* `allProductCategories`

  [[ProductCategory!]](https://developer.shopline.com/docs/admin-graph-ql-api/products-and-collections/objects/product-category.md)

  List of the store's standard product types. 
  <br></br>Maximum size: 1000.

* `features`

  [ShopFeatures!](https://developer.shopline.com/docs/admin-graph-ql-api/store-properties/objects/shop-features.md)

  Availability of store features. For example, if  `giftCards` returns `true`, it indicates that creating gift cards is allowed in the store.

* `resourceLimits`

  [ShopResourceLimits!](https://developer.shopline.com/docs/admin-graph-ql-api/store-properties/objects/shop-resource-limits.md)

  Store resource limits.

* `uploadedImagesByIds`

  [[Image!]](https://developer.shopline.com/docs/admin-graph-ql-api/common-objects/objects/image.md)

  List of images uploaded to the store.

* `productTypes`

  [StringConnection!](https://developer.shopline.com/docs/admin-graph-ql-api/common-objects/objects/string-connection.md)

  List of custom product types added to store products.

* `productTags`

  [StringConnection!](https://developer.shopline.com/docs/admin-graph-ql-api/common-objects/objects/string-connection.md)

  List of product tags assigned to store products.

* `productVendors`

  [StringConnection!](https://developer.shopline.com/docs/admin-graph-ql-api/common-objects/objects/string-connection.md)

  List of suppliers associated with store products.

## Examples

### Query store name, ID, email, currency, handle, time zone, and available features.

Query a store's information, including the store ID,  store name, currency, and other details.

**Request:**

```json
query Shop {
    shop {
       contactEmail
       name
       handle
       id
       currencyCode
       ianaTimezone
       allProductCategories {
        productTaxonomyNode {
            isRoot
            name
            fullName
            id
            isLeaf
        }
       }
       features {
        giftCards
        shopId
       }
       resourceLimits {
        maxProductOptions
        maxProductVariants
        shopId
       }
    }
}
```

**Response:**

```json
{
  "data": {
    "data": {
      "shop": {
        "allProductCategories": [
          {
            "productTaxonomyNode": {
              "isLeaf": true,
              "isRoot": false,
              "name": "Gift Cards & Certificates",
              "fullName": "Gift Giving < Party & Celebration < Arts & Entertainment < Gift Cards & Certificates",
              "id": "gid://shopline/ProductTaxonomyNode/53"
            }
          }
        ],
        "contactEmail": "ssc56474@gmail.com",
        "ianaTimezone": "Asia/Shanghai",
        "resourceLimits": {
          "maxProductOptions": 5,
          "maxProductVariants": 500,
          "shopId": "1672369729606"
        },
        "currencyCode": "USD",
        "name": "OpenAPI 测试店铺",
        "features": {
          "shopId": "1672369729606",
          "giftCards": true
        },
        "handle": "openapiceshidianpu",
        "id": "1672369729606"
      }
    },
    "extensions": {
      "cost": {
        "actualQueryCost": 6,
        "requestedQueryCost": 6,
        "throttleStatus": {
          "restoreRate": 5000,
          "currentlyAvailable": 4994,
          "maximumAvailable": 5000
        }
      }
    }
  }
}
```

## Error Handling

For detailed information about common codes, see [Status and error codes](https://developer.shopline.com/docs/apps/api-instructions-for-use/graph-ql-admin-api/overview.md#status-and-error-codes).