GraphQL Storefront API Reference
Queries
channel
Description
The current channel.
Response
Returns a Channel!
Example
Query
query channel {
channel {
entityId
metafields {
...MetafieldConnectionFragment
}
}
}
Response
{
"data": {
"channel": {
"entityId": {},
"metafields": MetafieldConnection
}
}
}
customer
Description
The currently logged in customer.
Response
Returns a Customer
Example
Query
query customer {
customer {
entityId
company
customerGroupId
email
firstName
lastName
notes
phone
taxExemptCategory
addressCount
attributeCount
storeCredit {
...MoneyFragment
}
attributes {
...CustomerAttributesFragment
}
wishlists {
...WishlistConnectionFragment
}
metafields {
...MetafieldConnectionFragment
}
formFields {
...CustomerFormFieldValueFragment
}
addresses {
...AddressConnectionFragment
}
}
}
Response
{
"data": {
"customer": {
"entityId": 987,
"company": "abc123",
"customerGroupId": 123,
"email": "abc123",
"firstName": "abc123",
"lastName": "xyz789",
"notes": "xyz789",
"phone": "xyz789",
"taxExemptCategory": "abc123",
"addressCount": 987,
"attributeCount": 123,
"storeCredit": [Money],
"attributes": CustomerAttributes,
"wishlists": WishlistConnection,
"metafields": MetafieldConnection,
"formFields": [CustomerFormFieldValue],
"addresses": AddressConnection
}
}
}
inventory
Description
An inventory
Response
Returns an Inventory!
Example
Query
query inventory {
inventory {
locations {
...InventoryLocationConnectionFragment
}
}
}
Response
{
"data": {
"inventory": {
"locations": InventoryLocationConnection
}
}
}
node
Description
Fetches an object given its ID
site
Description
A site
Response
Returns a Site!
Example
Query
query site {
site {
search {
...SearchQueriesFragment
}
categoryTree {
...CategoryTreeItemFragment
}
category {
...CategoryFragment
}
brands {
...BrandConnectionFragment
}
products {
...ProductConnectionFragment
}
newestProducts {
...ProductConnectionFragment
}
bestSellingProducts {
...ProductConnectionFragment
}
featuredProducts {
...ProductConnectionFragment
}
product {
...ProductFragment
}
route {
...RouteFragment
}
settings {
...SettingsFragment
}
content {
...ContentFragment
}
currency {
...CurrencyFragment
}
currencies {
...CurrencyConnectionFragment
}
publicWishlist {
...PublicWishlistFragment
}
popularBrands {
...PopularBrandConnectionFragment
}
cart {
...CartFragment
}
checkout {
...CheckoutFragment
}
brand {
...BrandFragment
}
}
}
Response
{
"data": {
"site": {
"search": SearchQueries,
"categoryTree": [CategoryTreeItem],
"category": Category,
"brands": BrandConnection,
"products": ProductConnection,
"newestProducts": ProductConnection,
"bestSellingProducts": ProductConnection,
"featuredProducts": ProductConnection,
"product": Product,
"route": Route,
"settings": Settings,
"content": Content,
"currency": Currency,
"currencies": CurrencyConnection,
"publicWishlist": PublicWishlist,
"popularBrands": PopularBrandConnection,
"cart": Cart,
"checkout": Checkout,
"brand": Brand
}
}
}
Mutations
cart
Description
The Cart mutations.
Response
Returns a CartMutations!
Example
Query
mutation cart {
cart {
createCart {
...CreateCartResultFragment
}
deleteCart {
...DeleteCartResultFragment
}
addCartLineItems {
...AddCartLineItemsResultFragment
}
updateCartLineItem {
...UpdateCartLineItemResultFragment
}
deleteCartLineItem {
...DeleteCartLineItemResultFragment
}
updateCartCurrency {
...UpdateCartCurrencyResultFragment
}
assignCartToCustomer {
...AssignCartToCustomerResultFragment
}
unassignCartFromCustomer {
...UnassignCartFromCustomerResultFragment
}
createCartMetafield {
...CreateCartMetafieldResultFragment
}
updateCartMetafield {
...UpdateCartMetafieldResultFragment
}
deleteCartMetafield {
...DeleteCartMetafieldResultFragment
}
createCartRedirectUrls {
...CreateCartRedirectUrlsResultFragment
}
}
}
Response
{
"data": {
"cart": {
"createCart": CreateCartResult,
"deleteCart": DeleteCartResult,
"addCartLineItems": AddCartLineItemsResult,
"updateCartLineItem": UpdateCartLineItemResult,
"deleteCartLineItem": DeleteCartLineItemResult,
"updateCartCurrency": UpdateCartCurrencyResult,
"assignCartToCustomer": AssignCartToCustomerResult,
"unassignCartFromCustomer": UnassignCartFromCustomerResult,
"createCartMetafield": CreateCartMetafieldResult,
"updateCartMetafield": UpdateCartMetafieldResult,
"deleteCartMetafield": DeleteCartMetafieldResult,
"createCartRedirectUrls": CreateCartRedirectUrlsResult
}
}
}
checkout
Description
The Checkout mutations.
Response
Returns a CheckoutMutations!
Example
Query
mutation checkout {
checkout {
addCheckoutBillingAddress {
...AddCheckoutBillingAddressResultFragment
}
updateCheckoutBillingAddress {
...UpdateCheckoutBillingAddressResultFragment
}
updateCheckoutCustomerMessage {
...UpdateCheckoutCustomerMessageResultFragment
}
selectCheckoutShippingOption {
...SelectCheckoutShippingOptionResultFragment
}
applyCheckoutCoupon {
...ApplyCheckoutCouponResultFragment
}
unapplyCheckoutCoupon {
...UnapplyCheckoutCouponResultFragment
}
applyCheckoutSpamProtection {
...ApplyCheckoutSpamProtectionResultFragment
}
addCheckoutShippingConsignments {
...AddCheckoutShippingConsignmentsResultFragment
}
updateCheckoutShippingConsignment {
...UpdateCheckoutShippingConsignmentResultFragment
}
deleteCheckoutConsignment {
...DeleteCheckoutConsignmentResultFragment
}
completeCheckout {
...CompleteCheckoutResultFragment
}
}
}
Response
{
"data": {
"checkout": {
"addCheckoutBillingAddress": AddCheckoutBillingAddressResult,
"updateCheckoutBillingAddress": UpdateCheckoutBillingAddressResult,
"updateCheckoutCustomerMessage": UpdateCheckoutCustomerMessageResult,
"selectCheckoutShippingOption": SelectCheckoutShippingOptionResult,
"applyCheckoutCoupon": ApplyCheckoutCouponResult,
"unapplyCheckoutCoupon": UnapplyCheckoutCouponResult,
"applyCheckoutSpamProtection": ApplyCheckoutSpamProtectionResult,
"addCheckoutShippingConsignments": AddCheckoutShippingConsignmentsResult,
"updateCheckoutShippingConsignment": UpdateCheckoutShippingConsignmentResult,
"deleteCheckoutConsignment": DeleteCheckoutConsignmentResult,
"completeCheckout": CompleteCheckoutResult
}
}
}
customer
Description
The customer mutations.
Response
Returns a CustomerMutations!
Example
Query
mutation customer {
customer {
changePassword {
...ChangePasswordResultFragment
}
requestResetPassword {
...RequestResetPasswordResultFragment
}
resetPassword {
...ResetPasswordResultFragment
}
registerCustomer {
...RegisterCustomerResultFragment
}
updateCustomer {
...UpdateCustomerResultFragment
}
addCustomerAddress {
...AddCustomerAddressResultFragment
}
updateCustomerAddress {
...UpdateCustomerAddressResultFragment
}
deleteCustomerAddress {
...DeleteCustomerAddressResultFragment
}
}
}
Response
{
"data": {
"customer": {
"changePassword": ChangePasswordResult,
"requestResetPassword": RequestResetPasswordResult,
"resetPassword": ResetPasswordResult,
"registerCustomer": RegisterCustomerResult,
"updateCustomer": UpdateCustomerResult,
"addCustomerAddress": AddCustomerAddressResult,
"updateCustomerAddress": UpdateCustomerAddressResult,
"deleteCustomerAddress": DeleteCustomerAddressResult
}
}
}
login
Description
Customer login
Response
Returns a LoginResult!
Example
Query
mutation login(
$email: String!,
$password: String!
) {
login(
email: $email,
password: $password
) {
result
customer {
...CustomerFragment
}
}
}
Variables
{
"email": "abc123",
"password": "xyz789"
}
Response
{
"data": {
"login": {
"result": "abc123",
"customer": Customer
}
}
}
logout
Description
Customer logout
Response
Returns a LogoutResult!
Example
Query
mutation logout {
logout {
result
}
}
Response
{"data": {"logout": {"result": "xyz789"}}}
submitContactUs
Description
Contact us mutation.
Response
Returns a SubmitContactUsResult!
Arguments
| Name | Description |
|---|---|
reCaptchaV2 - ReCaptchaV2Input
|
The reCaptchaV2 token. |
input - SubmitContactUsInput!
|
The content of the contact us form. |
Example
Query
mutation submitContactUs(
$reCaptchaV2: ReCaptchaV2Input,
$input: SubmitContactUsInput!
) {
submitContactUs(
reCaptchaV2: $reCaptchaV2,
input: $input
) {
errors {
... on ValidationError {
...ValidationErrorFragment
}
}
}
}
Variables
{
"reCaptchaV2": ReCaptchaV2Input,
"input": SubmitContactUsInput
}
Response
{
"data": {
"submitContactUs": {"errors": [ValidationError]}
}
}
wishlist
Description
The wishlist mutations.
Response
Returns a WishlistMutations!
Example
Query
mutation wishlist {
wishlist {
createWishlist {
...CreateWishlistResultFragment
}
addWishlistItems {
...AddWishlistItemsResultFragment
}
deleteWishlistItems {
...DeleteWishlistItemsResultFragment
}
updateWishlist {
...UpdateWishlistResultFragment
}
deleteWishlists {
...DeleteWishlistResultFragment
}
}
}
Response
{
"data": {
"wishlist": {
"createWishlist": CreateWishlistResult,
"addWishlistItems": AddWishlistItemsResult,
"deleteWishlistItems": DeleteWishlistItemsResult,
"updateWishlist": UpdateWishlistResult,
"deleteWishlists": DeleteWishlistResult
}
}
}
Types
AccountCreationDisabledError
Description
An error due to customer registration being disabled on a storefront.
Fields
| Field Name | Description |
|---|---|
message - String!
|
A description of the error. |
Example
{"message": "abc123"}
AddCartLineItemsDataInput
Description
Add cart line items data object
Fields
| Input Field | Description |
|---|---|
lineItems - [CartLineItemInput!]
|
List of cart line items |
giftCertificates - [CartGiftCertificateInput!]
|
List of gift certificates |
Example
{
"lineItems": [CartLineItemInput],
"giftCertificates": [CartGiftCertificateInput]
}
AddCartLineItemsInput
Description
Add cart line items input object
Fields
| Input Field | Description |
|---|---|
cartEntityId - String!
|
The cart id |
data - AddCartLineItemsDataInput!
|
Add cart line items data object |
Example
{
"cartEntityId": "abc123",
"data": AddCartLineItemsDataInput
}
AddCartLineItemsResult
Description
Add cart line items result
Fields
| Field Name | Description |
|---|---|
cart - Cart
|
The Cart that is updated as a result of mutation. |
Example
{"cart": Cart}
AddCheckoutBillingAddressDataInput
Description
Add checkout billing address data object
Fields
| Input Field | Description |
|---|---|
address - CheckoutAddressInput!
|
The checkout billing address |
Example
{"address": CheckoutAddressInput}
AddCheckoutBillingAddressInput
Description
Add checkout billing address input object
Fields
| Input Field | Description |
|---|---|
checkoutEntityId - String!
|
The checkout id |
data - AddCheckoutBillingAddressDataInput!
|
Add checkout billing address data object |
Example
{
"checkoutEntityId": "xyz789",
"data": AddCheckoutBillingAddressDataInput
}
AddCheckoutBillingAddressResult
Description
Add checkout billing address result
Fields
| Field Name | Description |
|---|---|
checkout - Checkout
|
The Checkout that is updated as a result of mutation. |
Example
{"checkout": Checkout}
AddCheckoutShippingConsignmentsDataInput
Description
Add checkout shipping consignments data object
Fields
| Input Field | Description |
|---|---|
consignments - [CheckoutShippingConsignmentInput!]!
|
The list of shipping consignments |
Example
{"consignments": [CheckoutShippingConsignmentInput]}
AddCheckoutShippingConsignmentsInput
Description
Add checkout shipping consignments input object
Fields
| Input Field | Description |
|---|---|
checkoutEntityId - String!
|
The checkout id |
data - AddCheckoutShippingConsignmentsDataInput!
|
Add checkout shipping consignments data object |
Example
{
"checkoutEntityId": "abc123",
"data": AddCheckoutShippingConsignmentsDataInput
}
AddCheckoutShippingConsignmentsResult
Description
Apply checkout shipping consignments result
Fields
| Field Name | Description |
|---|---|
checkout - Checkout
|
The Checkout that is updated as a result of mutation. |
Example
{"checkout": Checkout}
AddCustomerAddressError
Description
Possible response error when attempting to use AddCustomerAddress mutation.
Types
| Union Types |
|---|
Example
CustomerNotLoggedInError
AddCustomerAddressInput
Description
Input for adding a customer address.
Fields
| Input Field | Description |
|---|---|
firstName - String!
|
First name of the address owner. |
lastName - String!
|
Last name of the address owner. |
address1 - String!
|
First line for the street address. |
address2 - String
|
Second line for the street address. |
city - String!
|
City. |
company - String
|
Company name associated with the address. |
countryCode - String!
|
2-letter country code. |
stateOrProvince - String
|
Name of State or Province. |
phone - String
|
Phone number. |
postalCode - String
|
Postal code for the address. This is only required for certain countries. |
formFields - CustomerFormFieldsInput
|
Additional form fields defined by merchant. |
Example
{
"firstName": "abc123",
"lastName": "xyz789",
"address1": "abc123",
"address2": "xyz789",
"city": "abc123",
"company": "abc123",
"countryCode": "abc123",
"stateOrProvince": "abc123",
"phone": "abc123",
"postalCode": "abc123",
"formFields": CustomerFormFieldsInput
}
AddCustomerAddressResult
Description
Result of AddCustomerAddress mutation.
Fields
| Field Name | Description |
|---|---|
address - CustomerAddress
|
Customer address that was created. |
errors - [AddCustomerAddressError!]!
|
List of response errors when attempting to submit an address. |
Example
{
"address": CustomerAddress,
"errors": [CustomerNotLoggedInError]
}
AddWishlistItemsInput
Description
Add wishlist items input object
Fields
| Input Field | Description |
|---|---|
entityId - Int!
|
The wishlist id |
items - [WishlistItemInput!]!
|
The new wishlist items |
Example
{"entityId": 123, "items": [WishlistItemInput]}
AddWishlistItemsResult
Description
Add wishlist items
Fields
| Field Name | Description |
|---|---|
result - Wishlist!
|
The wishlist |
Example
{"result": Wishlist}
AddressConnection
Description
A connection to a list of customer addresses.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [AddressEdge!]
|
A list of edges. |
collectionInfo - CollectionInfo
|
Collection info. |
Example
{
"pageInfo": PageInfo,
"edges": [AddressEdge],
"collectionInfo": CollectionInfo
}
AddressDoesNotExistError
Description
An error due to providing an invalid or non-existent address ID.
Fields
| Field Name | Description |
|---|---|
message - String!
|
Error message. |
Example
{"message": "abc123"}
AddressEdge
Description
An edge in a connection.
Fields
| Field Name | Description |
|---|---|
node - CustomerAddress!
|
The item at the end of the edge. |
cursor - String!
|
A cursor for use in pagination. |
Example
{
"node": CustomerAddress,
"cursor": "xyz789"
}
Aggregated
Description
Aggregated
Fields
| Field Name | Description |
|---|---|
availableToSell - Long!
|
Number of available products in stock. This can be 'null' if inventory is not set orif the store's Inventory Settings disable displaying stock levels on the storefront. |
warningLevel - Int!
|
Indicates a threshold low-stock level. This can be 'null' if the inventory warning level is not set or if the store's Inventory Settings disable displaying stock levels on the storefront. |
Example
{"availableToSell": {}, "warningLevel": 987}
AggregatedInventory
Description
Aggregated Product Inventory
Fields
| Field Name | Description |
|---|---|
availableToSell - Int!
|
Number of available products in stock. This can be 'null' if inventory is not set orif the store's Inventory Settings disable displaying stock levels on the storefront. |
warningLevel - Int!
|
Indicates a threshold low-stock level. This can be 'null' if the inventory warning level is not set or if the store's Inventory Settings disable displaying stock levels on the storefront. |
Example
{"availableToSell": 123, "warningLevel": 123}
AlreadyExistsError
Description
Subject that should be created as a result of mutation would cause duplicate.
Fields
| Field Name | Description |
|---|---|
message - String!
|
A description of the error |
Example
{"message": "abc123"}
ApplyCheckoutCouponDataInput
Description
Apply checkout coupon data object
Fields
| Input Field | Description |
|---|---|
couponCode - String!
|
The checkout coupon code |
Example
{"couponCode": "xyz789"}
ApplyCheckoutCouponInput
Description
Apply checkout coupon input object
Fields
| Input Field | Description |
|---|---|
checkoutEntityId - String!
|
The checkout id |
data - ApplyCheckoutCouponDataInput!
|
Apply checkout coupon data object |
Example
{
"checkoutEntityId": "xyz789",
"data": ApplyCheckoutCouponDataInput
}
ApplyCheckoutCouponResult
Description
Apply checkout coupon result
Fields
| Field Name | Description |
|---|---|
checkout - Checkout
|
The Checkout that is updated as a result of mutation. |
Example
{"checkout": Checkout}
ApplyCheckoutSpamProtectionDataInput
Description
Apply checkout spam protection data object
Fields
| Input Field | Description |
|---|---|
token - String!
|
The checkout spam protection token |
Example
{"token": "abc123"}
ApplyCheckoutSpamProtectionInput
Description
Apply checkout spam protection input object
Fields
| Input Field | Description |
|---|---|
checkoutEntityId - String!
|
The checkout id |
data - ApplyCheckoutSpamProtectionDataInput!
|
Apply checkout spam protection data object |
Example
{
"checkoutEntityId": "abc123",
"data": ApplyCheckoutSpamProtectionDataInput
}
ApplyCheckoutSpamProtectionResult
Description
Apply checkout spam protection result
Fields
| Field Name | Description |
|---|---|
checkout - Checkout
|
The Checkout that is updated as a result of mutation. |
Example
{"checkout": Checkout}
AssignCartToCustomerInput
Description
Assign cart to the customer input object.
Fields
| Input Field | Description |
|---|---|
cartEntityId - String!
|
The cart id. |
Example
{"cartEntityId": "abc123"}
AssignCartToCustomerResult
Description
Assign cart to the customer result.
Fields
| Field Name | Description |
|---|---|
cart - Cart
|
The Cart that is updated as a result of mutation. |
Example
{"cart": Cart}
Author
Description
Author
Fields
| Field Name | Description |
|---|---|
name - String!
|
Author name. |
Example
{"name": "xyz789"}
Banner
Description
Banner details.
Fields
| Field Name | Description |
|---|---|
id - ID!
|
The ID of the banner. |
entityId - Long!
|
The id of the Banner. |
name - String!
|
The name of the Banner. |
content - String!
|
The content of the Banner. |
location - BannerLocation!
|
The location of the Banner. |
Example
{
"id": "4",
"entityId": {},
"name": "abc123",
"content": "xyz789",
"location": "BOTTOM"
}
BannerConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [BannerEdge!]
|
A list of edges. |
Example
{
"pageInfo": PageInfo,
"edges": [BannerEdge]
}
BannerEdge
BannerLocation
Description
Banner location
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
Example
"BOTTOM"
Banners
Description
Banners details.
Fields
| Field Name | Description |
|---|---|
homePage - BannerConnection!
|
List of home page banners. |
searchPage - BannerConnection!
|
List of search page banners. |
categoryPage - CategoryPageBannerConnection!
|
List of category page banners. |
brandPage - BrandPageBannerConnection!
|
List of brand page banners. |
Example
{
"homePage": BannerConnection,
"searchPage": BannerConnection,
"categoryPage": CategoryPageBannerConnection,
"brandPage": BrandPageBannerConnection
}
BigDecimal
Description
The BigDecimal scalar type represents signed fractional values with arbitrary precision.
Example
BigDecimal
Blog
Description
Blog details.
Fields
| Field Name | Description |
|---|---|
id - ID!
|
The ID of an object |
name - String!
|
The name of the Blog. |
description - String!
|
The description of the Blog. |
path - String!
|
The path of the Blog. |
isVisibleInNavigation - Boolean!
|
Whether or not the blog should be visible in the navigation menu. |
posts - BlogPostConnection!
|
Details of the Blog posts. |
post - BlogPost
|
Blog post details. |
Arguments
|
|
renderedRegions - RenderedRegionsByPageType!
|
The rendered regions for the blog index. |
Example
{
"id": "4",
"name": "abc123",
"description": "xyz789",
"path": "xyz789",
"isVisibleInNavigation": true,
"posts": BlogPostConnection,
"post": BlogPost,
"renderedRegions": RenderedRegionsByPageType
}
BlogIndexPage
Description
A blog index page.
Fields
| Field Name | Description |
|---|---|
id - ID!
|
The ID of an object |
path - String!
|
The URL path of the page. |
renderedRegions - RenderedRegionsByPageType!
|
The rendered regions for the web page. |
entityId - Int!
|
Unique ID for the web page. |
parentEntityId - Int
|
Unique ID for the parent page. |
name - String!
|
Page name. |
isVisibleInNavigation - Boolean!
|
Whether or not the page should be visible in the navigation menu. |
seo - SeoDetails!
|
Page SEO details. |
Example
{
"id": 4,
"path": "xyz789",
"renderedRegions": RenderedRegionsByPageType,
"entityId": 987,
"parentEntityId": 987,
"name": "xyz789",
"isVisibleInNavigation": true,
"seo": SeoDetails
}
BlogPost
Description
Blog post details.
Fields
| Field Name | Description |
|---|---|
id - ID!
|
The ID of an object |
entityId - Int!
|
Unique ID for the blog post. |
name - String!
|
Blog post name. |
tags - [String!]!
|
Blog post tags. |
path - String!
|
Blog post path. |
htmlBody - String!
|
The body of the Blog post. |
plainTextSummary - String!
|
The plain text summary of the Blog post. |
Arguments
|
|
publishedDate - DateTimeExtended!
|
Blog post published date. |
author - String
|
Blog post author. |
thumbnailImage - Image
|
Blog post thumbnail image. |
seo - SeoDetails!
|
Blog post SEO details. |
renderedRegions - RenderedRegionsByPageType!
|
The rendered regions for the blog post. |
Example
{
"id": 4,
"entityId": 987,
"name": "abc123",
"tags": ["xyz789"],
"path": "xyz789",
"htmlBody": "xyz789",
"plainTextSummary": "xyz789",
"publishedDate": DateTimeExtended,
"author": "xyz789",
"thumbnailImage": Image,
"seo": SeoDetails,
"renderedRegions": RenderedRegionsByPageType
}
BlogPostConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [BlogPostEdge!]
|
A list of edges. |
collectionInfo - CollectionInfo
|
Collection info |
Example
{
"pageInfo": PageInfo,
"edges": [BlogPostEdge],
"collectionInfo": CollectionInfo
}
BlogPostEdge
BlogPostRedirect
BlogPostsFiltersInput
Boolean
Description
The Boolean scalar type represents true or false.
Example
true
Brand
Description
Brand
Fields
| Field Name | Description |
|---|---|
id - ID!
|
The ID of an object |
entityId - Int!
|
Id of the brand. |
name - String!
|
Name of the brand. |
defaultImage - Image
|
Default image for brand. |
pageTitle - String!
|
Page title for the brand. Use SEO details instead. |
metaDesc - String!
|
Meta description for the brand. Use SEO details instead. |
metaKeywords - [String!]!
|
Meta keywords for the brand. Use SEO details instead. |
seo - SeoDetails!
|
Brand SEO details. |
searchKeywords - [String!]!
|
Search keywords for the brand. |
path - String!
|
Path for the brand page. |
products - ProductConnection!
|
List of products associated with the brand. |
Arguments
|
|
metafields - MetafieldConnection!
|
Metafield data related to a brand. |
Example
{
"id": "4",
"entityId": 123,
"name": "xyz789",
"defaultImage": Image,
"pageTitle": "abc123",
"metaDesc": "abc123",
"metaKeywords": ["abc123"],
"seo": SeoDetails,
"searchKeywords": ["abc123"],
"path": "xyz789",
"products": ProductConnection,
"metafields": MetafieldConnection
}
BrandConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [BrandEdge!]
|
A list of edges. |
Example
{
"pageInfo": PageInfo,
"edges": [BrandEdge]
}
BrandEdge
BrandPageBannerConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [BrandPageBannerEdge!]
|
A list of edges. |
Example
{
"pageInfo": PageInfo,
"edges": [BrandPageBannerEdge]
}
BrandPageBannerEdge
BrandRedirect
BrandSearchFilter
Description
Brand Filter
Fields
| Field Name | Description |
|---|---|
displayProductCount - Boolean!
|
Indicates whether to display product count next to the filter. |
brands - BrandSearchFilterItemConnection!
|
List of available brands. |
name - String!
|
Display name for the filter. |
isCollapsedByDefault - Boolean!
|
Indicates whether filter is collapsed by default. |
Example
{
"displayProductCount": true,
"brands": BrandSearchFilterItemConnection,
"name": "abc123",
"isCollapsedByDefault": false
}
BrandSearchFilterItem
Description
Specific brand filter item
Example
{
"entityId": 123,
"name": "abc123",
"isSelected": false,
"productCount": 987
}
BrandSearchFilterItemConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [BrandSearchFilterItemEdge!]
|
A list of edges. |
Example
{
"pageInfo": PageInfo,
"edges": [BrandSearchFilterItemEdge]
}
BrandSearchFilterItemEdge
Description
An edge in a connection.
Fields
| Field Name | Description |
|---|---|
node - BrandSearchFilterItem!
|
The item at the end of the edge. |
cursor - String!
|
A cursor for use in pagination. |
Example
{
"node": BrandSearchFilterItem,
"cursor": "xyz789"
}
Breadcrumb
BreadcrumbConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [BreadcrumbEdge!]
|
A list of edges. |
Example
{
"pageInfo": PageInfo,
"edges": [BreadcrumbEdge]
}
BreadcrumbEdge
Description
An edge in a connection.
Fields
| Field Name | Description |
|---|---|
node - Breadcrumb!
|
The item at the end of the edge. |
cursor - String!
|
A cursor for use in pagination. |
Example
{
"node": Breadcrumb,
"cursor": "abc123"
}
BulkPricingFixedPriceDiscount
Description
Bulk pricing tier that sets a fixed price for the product or variant.
Fields
| Field Name | Description |
|---|---|
price - BigDecimal!
|
This price will override the current product price. |
minimumQuantity - Int!
|
Minimum item quantity that applies to this bulk pricing tier. |
maximumQuantity - Int
|
Maximum item quantity that applies to this bulk pricing tier - if not defined then the tier does not have an upper bound. |
Example
{
"price": BigDecimal,
"minimumQuantity": 987,
"maximumQuantity": 123
}
BulkPricingPercentageDiscount
Description
Bulk pricing tier that reduces the price of the product or variant by a percentage.
Fields
| Field Name | Description |
|---|---|
percentOff - BigDecimal!
|
The percentage that will be removed from the product price. |
minimumQuantity - Int!
|
Minimum item quantity that applies to this bulk pricing tier. |
maximumQuantity - Int
|
Maximum item quantity that applies to this bulk pricing tier - if not defined then the tier does not have an upper bound. |
Example
{
"percentOff": BigDecimal,
"minimumQuantity": 987,
"maximumQuantity": 123
}
BulkPricingRelativePriceDiscount
Description
Bulk pricing tier that will subtract an amount from the price of the product or variant.
Fields
| Field Name | Description |
|---|---|
priceAdjustment - BigDecimal!
|
The price of the product/variant will be reduced by this priceAdjustment. |
minimumQuantity - Int!
|
Minimum item quantity that applies to this bulk pricing tier. |
maximumQuantity - Int
|
Maximum item quantity that applies to this bulk pricing tier - if not defined then the tier does not have an upper bound. |
Example
{
"priceAdjustment": BigDecimal,
"minimumQuantity": 123,
"maximumQuantity": 123
}
BulkPricingTier
Description
A set of bulk pricing tiers that define price discounts which apply when purchasing specified quantities of a product or variant.
Fields
| Field Name | Description |
|---|---|
minimumQuantity - Int!
|
Minimum item quantity that applies to this bulk pricing tier. |
maximumQuantity - Int
|
Maximum item quantity that applies to this bulk pricing tier - if not defined then the tier does not have an upper bound. |
Possible Types
| BulkPricingTier Types |
|---|
Example
{"minimumQuantity": 987, "maximumQuantity": 987}
Cart
Description
A cart
Fields
| Field Name | Description |
|---|---|
id - ID!
|
The ID of an object |
entityId - String!
|
Cart ID. |
currencyCode - String!
|
ISO-4217 currency code. |
isTaxIncluded - Boolean!
|
Whether this item is taxable. |
baseAmount - Money!
|
Cost of cart's contents, before applying discounts. |
discountedAmount - Money!
|
Discounted amount. |
amount - Money!
|
Sum of line-items amounts, minus cart-level discounts and coupons. This amount includes taxes (where applicable). |
discounts - [CartDiscount!]!
|
List of discounts applied to this cart. |
lineItems - CartLineItems!
|
List of line items. |
createdAt - DateTimeExtended!
|
Time when the cart was created. |
updatedAt - DateTimeExtended!
|
Time when the cart was last updated. |
locale - String!
|
Locale of the cart. |
metafields - MetafieldConnection!
|
Metafield data related to a cart. |
Example
{
"id": "4",
"entityId": "xyz789",
"currencyCode": "abc123",
"isTaxIncluded": true,
"baseAmount": Money,
"discountedAmount": Money,
"amount": Money,
"discounts": [CartDiscount],
"lineItems": CartLineItems,
"createdAt": DateTimeExtended,
"updatedAt": DateTimeExtended,
"locale": "xyz789",
"metafields": MetafieldConnection
}
CartCustomItem
Description
Cart custom item.
Fields
| Field Name | Description |
|---|---|
entityId - String!
|
ID of the custom item. |
sku - String
|
Custom item sku. |
name - String!
|
Custom item name. |
quantity - Int!
|
Quantity of this item. |
listPrice - Money!
|
Price of the item. With or without tax depending on your stores set up. |
extendedListPrice - Money!
|
Item's list price multiplied by the quantity. |
Example
{
"entityId": "abc123",
"sku": "xyz789",
"name": "xyz789",
"quantity": 987,
"listPrice": Money,
"extendedListPrice": Money
}
CartDigitalItem
Description
Cart digital item.
Fields
| Field Name | Description |
|---|---|
entityId - String!
|
The line-item ID. |
parentEntityId - String
|
The product is part of a bundle such as a product pick list, then the parentId or the main product id will populate. |
productEntityId - Int!
|
ID of the product. |
variantEntityId - Int
|
ID of the variant. |
sku - String
|
SKU of the variant. |
name - String!
|
The item's product name. |
url - String!
|
The product URL. |
imageUrl - String
|
URL of an image of this item, accessible on the internet. |
brand - String
|
The product brand. |
quantity - Int!
|
Quantity of this item. |
isTaxable - Boolean!
|
Whether the item is taxable. |
discounts - [CartDiscount!]!
|
List of discounts applied to this item. |
discountedAmount - Money!
|
The total value of all discounts applied to this item (excluding coupon). |
couponAmount - Money!
|
The total value of all coupons applied to this item. |
listPrice - Money!
|
The net item price before discounts and coupons. It is based on the product default price or sale price (if set) configured in BigCommerce Admin. |
originalPrice - Money!
|
An item’s original price is the same as the product default price in the admin panel. |
salePrice - Money!
|
Item's price after all discounts are applied. (The final price before tax calculation). |
extendedListPrice - Money!
|
Item's list price multiplied by the quantity. |
extendedSalePrice - Money!
|
Item's sale price multiplied by the quantity. |
selectedOptions - [CartSelectedOption!]!
|
The list of selected options for this product. |
Example
{
"entityId": "abc123",
"parentEntityId": "xyz789",
"productEntityId": 123,
"variantEntityId": 123,
"sku": "abc123",
"name": "abc123",
"url": "xyz789",
"imageUrl": "xyz789",
"brand": "abc123",
"quantity": 987,
"isTaxable": false,
"discounts": [CartDiscount],
"discountedAmount": Money,
"couponAmount": Money,
"listPrice": Money,
"originalPrice": Money,
"salePrice": Money,
"extendedListPrice": Money,
"extendedSalePrice": Money,
"selectedOptions": [CartSelectedOption]
}
CartDiscount
CartGiftCertificate
Description
Cart gift certificate
Fields
| Field Name | Description |
|---|---|
entityId - String!
|
ID of this gift certificate. |
name - String!
|
GiftCertificate-provided name that will appear in the control panel. |
theme - CartGiftCertificateTheme!
|
Currently supports Birthday, Boy, Celebration, Christmas, General, and Girl. |
amount - Money!
|
Value must be between 1.00 and 1,000.00 in the store's default currency. |
isTaxable - Boolean!
|
Whether or not the gift certificate is taxable. |
sender - CartGiftCertificateSender!
|
Sender of the gift certificate. |
recipient - CartGiftCertificateRecipient!
|
Recipient of the gift certificate. |
message - String
|
Message that will be sent to the gift certificate's recipient. Limited to 200 characters. |
Example
{
"entityId": "xyz789",
"name": "abc123",
"theme": "BIRTHDAY",
"amount": Money,
"isTaxable": true,
"sender": CartGiftCertificateSender,
"recipient": CartGiftCertificateRecipient,
"message": "abc123"
}
CartGiftCertificateInput
Description
Cart gift certificate input object
Fields
| Input Field | Description |
|---|---|
name - String!
|
GiftCertificate-provided name that will appear in the control panel. |
theme - CartGiftCertificateTheme!
|
Currently supports Birthday, Boy, Celebration, Christmas, General, and Girl. |
amount - BigDecimal!
|
Value must be between 1.00 and 1,000.00 in the store's default currency. |
quantity - Int!
|
The total number of certificates |
sender - CartGiftCertificateSenderInput!
|
Sender of the gift certificate. |
recipient - CartGiftCertificateRecipientInput!
|
Recipient of the gift certificate. |
message - String
|
Message that will be sent to the gift certificate's recipient. Limited to 200 characters. |
Example
{
"name": "abc123",
"theme": "BIRTHDAY",
"amount": BigDecimal,
"quantity": 987,
"sender": CartGiftCertificateSenderInput,
"recipient": CartGiftCertificateRecipientInput,
"message": "xyz789"
}
CartGiftCertificateRecipient
CartGiftCertificateRecipientInput
CartGiftCertificateSender
CartGiftCertificateSenderInput
CartGiftCertificateTheme
Description
Cart gift certificate theme
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"BIRTHDAY"
CartGiftWrapping
Description
Gift wrapping for the item
Example
{
"name": "xyz789",
"amount": Money,
"message": "abc123"
}
CartLineItemInput
Description
Cart line item input object
Fields
| Input Field | Description |
|---|---|
quantity - Int!
|
Total number of line items. |
productEntityId - Int!
|
The product id |
variantEntityId - Int
|
The variant id |
selectedOptions - CartSelectedOptionsInput
|
The list of selected options for this item. |
Example
{
"quantity": 987,
"productEntityId": 123,
"variantEntityId": 123,
"selectedOptions": CartSelectedOptionsInput
}
CartLineItems
Description
Cart line items
Fields
| Field Name | Description |
|---|---|
physicalItems - [CartPhysicalItem!]!
|
List of physical items. |
digitalItems - [CartDigitalItem!]!
|
List of digital items. |
giftCertificates - [CartGiftCertificate!]!
|
List of gift certificates. |
customItems - [CartCustomItem!]!
|
List of custom items. |
totalQuantity - Int!
|
Total number of line items. |
Example
{
"physicalItems": [CartPhysicalItem],
"digitalItems": [CartDigitalItem],
"giftCertificates": [CartGiftCertificate],
"customItems": [CartCustomItem],
"totalQuantity": 123
}
CartMutations
Description
Cart mutations
Fields
| Field Name | Description |
|---|---|
createCart - CreateCartResult
|
Creates a cart and generates a cart ID. |
Arguments
|
|
deleteCart - DeleteCartResult
|
Deletes a Cart. |
Arguments
|
|
addCartLineItems - AddCartLineItemsResult
|
Adds line item(s) to the cart. |
Arguments
|
|
updateCartLineItem - UpdateCartLineItemResult
|
Updates line item in the cart. |
Arguments
|
|
deleteCartLineItem - DeleteCartLineItemResult
|
Delete line item in the cart. Removing the last line item in the Cart deletes the Cart. |
Arguments
|
|
updateCartCurrency - UpdateCartCurrencyResult
|
Update currency of the cart. |
Arguments
|
|
assignCartToCustomer - AssignCartToCustomerResult
|
Assign cart to the customer. |
Arguments
|
|
unassignCartFromCustomer - UnassignCartFromCustomerResult
|
Unassign cart from the customer. |
Arguments
|
|
createCartMetafield - CreateCartMetafieldResult!
|
Creates a metafield for cart object. |
Arguments
|
|
updateCartMetafield - UpdateCartMetafieldResult!
|
Updates a metafield for cart object. |
Arguments
|
|
deleteCartMetafield - DeleteCartMetafieldResult!
|
Deletes a metafield for cart object. |
Arguments
|
|
createCartRedirectUrls - CreateCartRedirectUrlsResult!
|
Create single-use redirect URLs for a cart. |
Arguments
|
|
Example
{
"createCart": CreateCartResult,
"deleteCart": DeleteCartResult,
"addCartLineItems": AddCartLineItemsResult,
"updateCartLineItem": UpdateCartLineItemResult,
"deleteCartLineItem": DeleteCartLineItemResult,
"updateCartCurrency": UpdateCartCurrencyResult,
"assignCartToCustomer": AssignCartToCustomerResult,
"unassignCartFromCustomer": UnassignCartFromCustomerResult,
"createCartMetafield": CreateCartMetafieldResult,
"updateCartMetafield": UpdateCartMetafieldResult,
"deleteCartMetafield": DeleteCartMetafieldResult,
"createCartRedirectUrls": CreateCartRedirectUrlsResult
}
CartPhysicalItem
Description
Cart physical item.
Fields
| Field Name | Description |
|---|---|
entityId - String!
|
The line-item ID. |
parentEntityId - String
|
The product is part of a bundle such as a product pick list, then the parentId or the main product id will populate. |
productEntityId - Int!
|
ID of the product. |
variantEntityId - Int
|
ID of the variant. |
sku - String
|
SKU of the variant. |
name - String!
|
The item's product name. |
url - String!
|
The product URL. |
imageUrl - String
|
URL of an image of this item, accessible on the internet. |
brand - String
|
The product brand. |
quantity - Int!
|
Quantity of this item. |
isTaxable - Boolean!
|
Whether the item is taxable. |
discounts - [CartDiscount!]!
|
List of discounts applied to this item. |
discountedAmount - Money!
|
The total value of all discounts applied to this item (excluding coupon). |
couponAmount - Money!
|
The total value of all coupons applied to this item. |
listPrice - Money!
|
The net item price before discounts and coupons. It is based on the product default price or sale price (if set) configured in BigCommerce Admin. |
originalPrice - Money!
|
An item’s original price is the same as the product default price in the admin panel. |
salePrice - Money!
|
Item's price after all discounts are applied. (The final price before tax calculation). |
extendedListPrice - Money!
|
Item's list price multiplied by the quantity. |
extendedSalePrice - Money!
|
Item's sale price multiplied by the quantity. |
isShippingRequired - Boolean!
|
Whether this item requires shipping to a physical address. |
selectedOptions - [CartSelectedOption!]!
|
The list of selected options for this item. |
giftWrapping - CartGiftWrapping
|
Gift wrapping for this item. |
Example
{
"entityId": "xyz789",
"parentEntityId": "xyz789",
"productEntityId": 123,
"variantEntityId": 123,
"sku": "xyz789",
"name": "abc123",
"url": "xyz789",
"imageUrl": "xyz789",
"brand": "xyz789",
"quantity": 123,
"isTaxable": false,
"discounts": [CartDiscount],
"discountedAmount": Money,
"couponAmount": Money,
"listPrice": Money,
"originalPrice": Money,
"salePrice": Money,
"extendedListPrice": Money,
"extendedSalePrice": Money,
"isShippingRequired": true,
"selectedOptions": [CartSelectedOption],
"giftWrapping": CartGiftWrapping
}
CartRedirectUrls
Description
Cart redirect URLs.
Example
{
"redirectedCheckoutUrl": "abc123",
"embeddedCheckoutUrl": "abc123"
}
CartSelectedCheckboxOption
Description
Selected checkbox option.
Example
{
"entityId": 123,
"name": "xyz789",
"value": "xyz789",
"valueEntityId": 123
}
CartSelectedCheckboxOptionInput
CartSelectedDateFieldOption
Description
Selected date field option.
Fields
| Field Name | Description |
|---|---|
entityId - Int!
|
The product option ID. |
name - String!
|
The product option name. |
date - DateTimeExtended!
|
Date value. |
Example
{
"entityId": 123,
"name": "xyz789",
"date": DateTimeExtended
}
CartSelectedDateFieldOptionInput
CartSelectedFileUploadOption
CartSelectedMultiLineTextFieldOption
CartSelectedMultiLineTextFieldOptionInput
CartSelectedMultipleChoiceOption
Description
Selected multiple choice option.
Example
{
"entityId": 987,
"name": "xyz789",
"value": "abc123",
"valueEntityId": 987
}
CartSelectedMultipleChoiceOptionInput
CartSelectedNumberFieldOption
CartSelectedNumberFieldOptionInput
CartSelectedOption
CartSelectedOptionsInput
Description
Selected product options.
Fields
| Input Field | Description |
|---|---|
checkboxes - [CartSelectedCheckboxOptionInput!]
|
List of selected checkbox options. |
dateFields - [CartSelectedDateFieldOptionInput!]
|
List of selected date field options. |
multiLineTextFields - [CartSelectedMultiLineTextFieldOptionInput!]
|
List of selected multi-line text field options. |
multipleChoices - [CartSelectedMultipleChoiceOptionInput!]
|
List of selected multiple choice options. |
numberFields - [CartSelectedNumberFieldOptionInput!]
|
List of selected number field options. |
textFields - [CartSelectedTextFieldOptionInput!]
|
List of selected text field options. |
Example
{
"checkboxes": [CartSelectedCheckboxOptionInput],
"dateFields": [CartSelectedDateFieldOptionInput],
"multiLineTextFields": [
CartSelectedMultiLineTextFieldOptionInput
],
"multipleChoices": [
CartSelectedMultipleChoiceOptionInput
],
"numberFields": [CartSelectedNumberFieldOptionInput],
"textFields": [CartSelectedTextFieldOptionInput]
}
CartSelectedTextFieldOption
CartSelectedTextFieldOptionInput
Catalog
Description
Storefront catalog settings.
Fields
| Field Name | Description |
|---|---|
productComparisonsEnabled - Boolean
|
Product comparisons enabled. |
Example
{"productComparisonsEnabled": true}
CatalogProductOption
Description
Product Option
Fields
| Field Name | Description |
|---|---|
entityId - Int!
|
Unique ID for the option. |
displayName - String!
|
Display name for the option. |
isRequired - Boolean!
|
One of the option values is required to be selected for the checkout. |
isVariantOption - Boolean!
|
Indicates whether it is a variant option or modifier. |
Possible Types
| CatalogProductOption Types |
|---|
Example
{
"entityId": 987,
"displayName": "abc123",
"isRequired": true,
"isVariantOption": true
}
CatalogProductOptionValue
Description
Product Option Value
Fields
| Field Name | Description |
|---|---|
entityId - Int!
|
Unique ID for the option value. |
label - String!
|
Label for the option value. |
isDefault - Boolean!
|
Indicates whether this value is the chosen default selected value. |
isSelected - Boolean
|
Indicates whether this value is selected based on sku/variantEntityId/optionValueIds overlay requested on the product node level. |
Possible Types
| CatalogProductOptionValue Types |
|---|
Example
{
"entityId": 123,
"label": "abc123",
"isDefault": false,
"isSelected": false
}
Category
Description
Category
Fields
| Field Name | Description |
|---|---|
id - ID!
|
The ID of an object |
entityId - Int!
|
Unique ID for the category. |
name - String!
|
Category name. |
path - String!
|
Category path. |
defaultImage - Image
|
Default image for the category. |
description - String!
|
Category description. |
breadcrumbs - BreadcrumbConnection!
|
Category breadcrumbs. |
products - ProductConnection!
|
List of products associated with category |
Arguments
|
|
metafields - MetafieldConnection!
|
Metafield data related to a category. |
seo - SeoDetails!
|
Category SEO details. |
shopByPriceRanges - ShopByPriceConnection!
|
Category shop by price money ranges. Alpha version. Do not use in production. |
defaultProductSort - CategoryProductSort
|
Category default product sort. |
Example
{
"id": "4",
"entityId": 123,
"name": "xyz789",
"path": "xyz789",
"defaultImage": Image,
"description": "xyz789",
"breadcrumbs": BreadcrumbConnection,
"products": ProductConnection,
"metafields": MetafieldConnection,
"seo": SeoDetails,
"shopByPriceRanges": ShopByPriceConnection,
"defaultProductSort": "A_TO_Z"
}
CategoryConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [CategoryEdge!]
|
A list of edges. |
Example
{
"pageInfo": PageInfo,
"edges": [CategoryEdge]
}
CategoryEdge
CategoryPageBannerConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [CategoryPageBannerEdge!]
|
A list of edges. |
Example
{
"pageInfo": PageInfo,
"edges": [CategoryPageBannerEdge]
}
CategoryPageBannerEdge
CategoryProductSort
Description
Product sorting by categories.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"A_TO_Z"
CategoryRedirect
CategorySearchFilter
Description
Category Filter
Fields
| Field Name | Description |
|---|---|
displayProductCount - Boolean!
|
Indicates whether to display product count next to the filter. |
categories - CategorySearchFilterItemConnection!
|
List of available categories. |
name - String!
|
Display name for the filter. |
isCollapsedByDefault - Boolean!
|
Indicates whether filter is collapsed by default. |
Example
{
"displayProductCount": true,
"categories": CategorySearchFilterItemConnection,
"name": "abc123",
"isCollapsedByDefault": true
}
CategorySearchFilterItem
Description
Specific category filter item
Fields
| Field Name | Description |
|---|---|
entityId - Int!
|
Category ID. |
name - String!
|
Category name. |
isSelected - Boolean!
|
Indicates whether category is selected. |
productCount - Int!
|
Indicates how many products available for this filter. |
subCategories - SubCategorySearchFilterItemConnection!
|
List of available sub-categories. |
Example
{
"entityId": 987,
"name": "abc123",
"isSelected": true,
"productCount": 987,
"subCategories": SubCategorySearchFilterItemConnection
}
CategorySearchFilterItemConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [CategorySearchFilterItemEdge!]
|
A list of edges. |
Example
{
"pageInfo": PageInfo,
"edges": [CategorySearchFilterItemEdge]
}
CategorySearchFilterItemEdge
Description
An edge in a connection.
Fields
| Field Name | Description |
|---|---|
node - CategorySearchFilterItem!
|
The item at the end of the edge. |
cursor - String!
|
A cursor for use in pagination. |
Example
{
"node": CategorySearchFilterItem,
"cursor": "abc123"
}
CategoryTreeItem
Description
An item in a tree of categories.
Fields
| Field Name | Description |
|---|---|
entityId - Int!
|
The id category. |
name - String!
|
The name of category. |
path - String!
|
Path assigned to this category |
description - String!
|
The description of this category. |
productCount - Int!
|
The number of products in this category. |
image - Image
|
The category image. |
hasChildren - Boolean!
|
If a category has children. |
children - [CategoryTreeItem!]!
|
Subcategories of this category |
Example
{
"entityId": 987,
"name": "abc123",
"path": "xyz789",
"description": "xyz789",
"productCount": 987,
"image": Image,
"hasChildren": false,
"children": [CategoryTreeItem]
}
ChangePasswordError
Description
An error that occurred while changing a password.
Example
ValidationError
ChangePasswordInput
Description
The input for changing a customer password.
Example
{
"currentPassword": "abc123",
"newPassword": "abc123"
}
ChangePasswordResult
Description
The result of changing a password.
Fields
| Field Name | Description |
|---|---|
errors - [ChangePasswordError!]!
|
Errors encountered while changing the password. |
Example
{"errors": [ValidationError]}
Channel
Description
The Channel
Fields
| Field Name | Description |
|---|---|
entityId - Long!
|
The ID of the channel. |
metafields - MetafieldConnection!
|
Metafield data related to a channel. |
Example
{"entityId": {}, "metafields": MetafieldConnection}
CheckboxOption
Description
A simple yes/no question represented by a checkbox.
Fields
| Field Name | Description |
|---|---|
checkedByDefault - Boolean!
|
Indicates the default checked status. |
label - String!
|
Label of the checkbox option. |
checkedOptionValueEntityId - Int!
|
Option value entity ID used for specifying the checkbox is checked. |
uncheckedOptionValueEntityId - Int!
|
Option value entity ID used for specifying the checkbox is not checked. |
entityId - Int!
|
Unique ID for the option. |
displayName - String!
|
Display name for the option. |
isRequired - Boolean!
|
One of the option values is required to be selected for the checkout. |
isVariantOption - Boolean!
|
Indicates whether it is a variant option or modifier. |
Example
{
"checkedByDefault": false,
"label": "abc123",
"checkedOptionValueEntityId": 987,
"uncheckedOptionValueEntityId": 987,
"entityId": 987,
"displayName": "xyz789",
"isRequired": false,
"isVariantOption": false
}
CheckboxesFormField
Description
Checkboxes form field.
Fields
| Field Name | Description |
|---|---|
options - [FormFieldOption!]!
|
The options for the form field. |
entityId - Int!
|
The entity ID of the form field. |
label - String!
|
The label to display for the form field. |
sortOrder - Int!
|
The sort order priority of the form field. |
isBuiltIn - Boolean!
|
Indicates whether the form field is built-in. |
isRequired - Boolean!
|
Indicates whether the form field is required. |
Example
{
"options": [FormFieldOption],
"entityId": 123,
"label": "xyz789",
"sortOrder": 123,
"isBuiltIn": true,
"isRequired": true
}
CheckboxesFormFieldInput
CheckboxesFormFieldValue
Description
Checkboxes custom form field result.
Fields
| Field Name | Description |
|---|---|
valueEntityIds - [Int!]!
|
List of checkbox value ids selected by customer. |
values - [String!]!
|
List of checkbox values selected by customer. |
entityId - Int!
|
Entity ID of a custom form field value on a customer or customer address. |
name - String!
|
The name of the form field that the value is for. |
Example
{
"valueEntityIds": [987],
"values": ["abc123"],
"entityId": 987,
"name": "abc123"
}
Checkout
Description
The checkout.
Fields
| Field Name | Description |
|---|---|
id - ID!
|
The ID of an object |
entityId - String!
|
Checkout ID. |
billingAddress - CheckoutBillingAddress
|
Billing address information. |
cart - Cart
|
Cart associated with the checkout. |
shippingConsignments - [CheckoutShippingConsignment!]
|
List of shipping consignments. |
order - Order
|
Order associated with the checkout. |
shippingCostTotal - Money
|
Total shipping cost before any discounts are applied. |
giftWrappingCostTotal - Money
|
Gift wrapping cost for all items, including or excluding tax. |
handlingCostTotal - Money
|
Handling cost for all consignments including or excluding tax. |
taxTotal - Money
|
Total amount of taxes applied. |
taxes - [CheckoutTax!]
|
List of taxes applied. |
subtotal - Money
|
Subtotal of the checkout before applying item-level discounts. Tax inclusive based on the store settings. |
grandTotal - Money
|
The total payable amount, before applying any store credit or gift certificate. |
createdAt - DateTimeExtended!
|
Time when the checkout was created. |
updatedAt - DateTimeExtended!
|
Time when the checkout was last updated. |
customerMessage - String
|
Shopper's message provided as details for the order to be created from the checkout. |
outstandingBalance - Money
|
GrandTotal subtract the store-credit amount. |
coupons - [CheckoutCoupon!]!
|
Coupons applied at checkout level. |
promotions - [CheckoutPromotion!]!
|
List of promotions |
Example
{
"id": "4",
"entityId": "abc123",
"billingAddress": CheckoutBillingAddress,
"cart": Cart,
"shippingConsignments": [CheckoutShippingConsignment],
"order": Order,
"shippingCostTotal": Money,
"giftWrappingCostTotal": Money,
"handlingCostTotal": Money,
"taxTotal": Money,
"taxes": [CheckoutTax],
"subtotal": Money,
"grandTotal": Money,
"createdAt": DateTimeExtended,
"updatedAt": DateTimeExtended,
"customerMessage": "xyz789",
"outstandingBalance": Money,
"coupons": [CheckoutCoupon],
"promotions": [CheckoutPromotion]
}
CheckoutAddress
Description
Checkout address.
Fields
| Field Name | Description |
|---|---|
firstName - String
|
The first name. |
lastName - String
|
The last name. |
email - String
|
Email address. |
company - String
|
Company name. |
address1 - String
|
Address line 1. |
address2 - String
|
Address line 2. |
city - String
|
Name of the city. |
stateOrProvince - String
|
State or province. |
stateOrProvinceCode - String
|
Code of the state or province. |
countryCode - String!
|
Country code. |
postalCode - String
|
Postal code. |
phone - String
|
Phone number. |
customFields - [CheckoutAddressCustomField!]!
|
List of custom fields. |
Possible Types
| CheckoutAddress Types |
|---|
Example
{
"firstName": "xyz789",
"lastName": "xyz789",
"email": "abc123",
"company": "abc123",
"address1": "xyz789",
"address2": "xyz789",
"city": "abc123",
"stateOrProvince": "abc123",
"stateOrProvinceCode": "xyz789",
"countryCode": "xyz789",
"postalCode": "xyz789",
"phone": "abc123",
"customFields": [CheckoutAddressCustomField]
}
CheckoutAddressCheckboxesCustomField
CheckoutAddressCheckboxesCustomFieldInput
CheckoutAddressCustomField
Description
Custom field of the checkout address.
Fields
| Field Name | Description |
|---|---|
entityId - Int!
|
Custom field ID. |
Possible Types
| CheckoutAddressCustomField Types |
|---|
Example
{"entityId": 987}
CheckoutAddressCustomFieldInput
Description
Checkout address custom field input object
Fields
| Input Field | Description |
|---|---|
checkboxes - [CheckoutAddressCheckboxesCustomFieldInput!]
|
List of checkboxes custom fields. |
multipleChoices - [CheckoutAddressMultipleChoiceCustomFieldInput!]
|
List of multiple choice custom fields. |
numbers - [CheckoutAddressNumberCustomFieldInput!]
|
List of number custom fields. |
dates - [CheckoutAddressDateCustomFieldInput!]
|
List of date custom fields. |
texts - [CheckoutAddressTextCustomFieldInput!]
|
List of text custom fields. |
passwords - [CheckoutAddressPasswordCustomFieldInput!]
|
List of password custom fields. |
Example
{
"checkboxes": [
CheckoutAddressCheckboxesCustomFieldInput
],
"multipleChoices": [
CheckoutAddressMultipleChoiceCustomFieldInput
],
"numbers": [CheckoutAddressNumberCustomFieldInput],
"dates": [CheckoutAddressDateCustomFieldInput],
"texts": [CheckoutAddressTextCustomFieldInput],
"passwords": [CheckoutAddressPasswordCustomFieldInput]
}
CheckoutAddressDateCustomField
Description
Date custom field.
Fields
| Field Name | Description |
|---|---|
date - DateTimeExtended!
|
Date value. |
entityId - Int!
|
Custom field ID. |
Example
{"date": DateTimeExtended, "entityId": 123}
CheckoutAddressDateCustomFieldInput
CheckoutAddressInput
Description
Checkout address input object
Fields
| Input Field | Description |
|---|---|
firstName - String
|
The first name |
lastName - String
|
The last name |
email - String
|
Email address |
company - String
|
Company name |
address1 - String
|
Address line 1 |
address2 - String
|
Address line 2 |
city - String
|
Name of the city |
stateOrProvince - String
|
State or province |
stateOrProvinceCode - String
|
Code of the state or province |
countryCode - String!
|
Country code |
postalCode - String
|
Postal code |
phone - String
|
Phone number |
customFields - CheckoutAddressCustomFieldInput
|
List of custom fields |
shouldSaveAddress - Boolean!
|
Should we save this address? |
Example
{
"firstName": "abc123",
"lastName": "xyz789",
"email": "abc123",
"company": "abc123",
"address1": "abc123",
"address2": "xyz789",
"city": "abc123",
"stateOrProvince": "xyz789",
"stateOrProvinceCode": "xyz789",
"countryCode": "xyz789",
"postalCode": "abc123",
"phone": "abc123",
"customFields": CheckoutAddressCustomFieldInput,
"shouldSaveAddress": true
}
CheckoutAddressMultipleChoiceCustomField
CheckoutAddressMultipleChoiceCustomFieldInput
CheckoutAddressNumberCustomField
CheckoutAddressNumberCustomFieldInput
CheckoutAddressPasswordCustomField
CheckoutAddressPasswordCustomFieldInput
CheckoutAddressTextCustomFieldInput
CheckoutAddressTextFieldCustomField
CheckoutAvailableShippingOption
Description
Available shipping option.
Fields
| Field Name | Description |
|---|---|
entityId - String!
|
Shipping option ID. |
description - String!
|
Shipping option description. |
type - String!
|
Shipping option type. Flat rate, UPS, etc. |
imageUrl - String
|
Shipping option image URL. |
cost - Money!
|
Shipping option cost. |
transitTime - String
|
An estimate of the arrival time. |
isRecommended - Boolean!
|
Is this shipping method the recommended shipping option or not. |
Example
{
"entityId": "xyz789",
"description": "abc123",
"type": "xyz789",
"imageUrl": "abc123",
"cost": Money,
"transitTime": "abc123",
"isRecommended": true
}
CheckoutBillingAddress
Description
Checkboxes billing address.
Fields
| Field Name | Description |
|---|---|
entityId - String!
|
Billing address ID. |
firstName - String
|
The first name. |
lastName - String
|
The last name. |
email - String
|
Email address. |
company - String
|
Company name. |
address1 - String
|
Address line 1. |
address2 - String
|
Address line 2. |
city - String
|
Name of the city. |
stateOrProvince - String
|
State or province. |
stateOrProvinceCode - String
|
Code of the state or province. |
countryCode - String!
|
Country code. |
postalCode - String
|
Postal code. |
phone - String
|
Phone number. |
customFields - [CheckoutAddressCustomField!]!
|
List of custom fields. |
Example
{
"entityId": "abc123",
"firstName": "abc123",
"lastName": "abc123",
"email": "abc123",
"company": "abc123",
"address1": "xyz789",
"address2": "xyz789",
"city": "xyz789",
"stateOrProvince": "abc123",
"stateOrProvinceCode": "xyz789",
"countryCode": "abc123",
"postalCode": "abc123",
"phone": "abc123",
"customFields": [CheckoutAddressCustomField]
}
CheckoutConsignmentAddress
Description
Checkboxes consignment address.
Fields
| Field Name | Description |
|---|---|
firstName - String
|
The first name. |
lastName - String
|
The last name. |
email - String
|
Email address. |
company - String
|
Company name. |
address1 - String
|
Address line 1. |
address2 - String
|
Address line 2. |
city - String
|
Name of the city. |
stateOrProvince - String
|
State or province. |
stateOrProvinceCode - String
|
Code of the state or province. |
countryCode - String!
|
Country code. |
postalCode - String
|
Postal code. |
phone - String
|
Phone number. |
customFields - [CheckoutAddressCustomField!]!
|
List of custom fields. |
Example
{
"firstName": "abc123",
"lastName": "xyz789",
"email": "abc123",
"company": "abc123",
"address1": "abc123",
"address2": "abc123",
"city": "abc123",
"stateOrProvince": "xyz789",
"stateOrProvinceCode": "abc123",
"countryCode": "xyz789",
"postalCode": "abc123",
"phone": "abc123",
"customFields": [CheckoutAddressCustomField]
}
CheckoutConsignmentLineItemInput
CheckoutCoupon
Description
The checkout coupon.
Fields
| Field Name | Description |
|---|---|
entityId - Int!
|
The coupon ID. |
code - String!
|
The coupon code. |
couponType - CouponType
|
The coupon type. |
discountedAmount - Money!
|
The discounted amount applied within a given context. |
Example
{
"entityId": 123,
"code": "xyz789",
"couponType": "FREE_SHIPPING",
"discountedAmount": Money
}
CheckoutMutations
Description
Checkout mutations
Fields
| Field Name | Description |
|---|---|
addCheckoutBillingAddress - AddCheckoutBillingAddressResult
|
Creates a checkout billing address. |
Arguments
|
|
updateCheckoutBillingAddress - UpdateCheckoutBillingAddressResult
|
Update a checkout billing address. |
Arguments
|
|
updateCheckoutCustomerMessage - UpdateCheckoutCustomerMessageResult
|
Updates a checkout customer message. |
Arguments
|
|
selectCheckoutShippingOption - SelectCheckoutShippingOptionResult
|
Selects a checkout shipping option. |
Arguments
|
|
applyCheckoutCoupon - ApplyCheckoutCouponResult
|
Applies a checkout coupon. |
Arguments
|
|
unapplyCheckoutCoupon - UnapplyCheckoutCouponResult
|
Unapply a checkout coupon. |
Arguments
|
|
applyCheckoutSpamProtection - ApplyCheckoutSpamProtectionResult
|
Applies a checkout spam protection. |
Arguments
|
|
addCheckoutShippingConsignments - AddCheckoutShippingConsignmentsResult
|
Creates a checkout shipping consignments. |
Arguments
|
|
updateCheckoutShippingConsignment - UpdateCheckoutShippingConsignmentResult
|
Updates a checkout shipping consignments. |
Arguments
|
|
deleteCheckoutConsignment - DeleteCheckoutConsignmentResult
|
Deletes a checkout consignment. |
Arguments
|
|
completeCheckout - CompleteCheckoutResult
|
Completes the checkout. |
Arguments
|
|
Example
{
"addCheckoutBillingAddress": AddCheckoutBillingAddressResult,
"updateCheckoutBillingAddress": UpdateCheckoutBillingAddressResult,
"updateCheckoutCustomerMessage": UpdateCheckoutCustomerMessageResult,
"selectCheckoutShippingOption": SelectCheckoutShippingOptionResult,
"applyCheckoutCoupon": ApplyCheckoutCouponResult,
"unapplyCheckoutCoupon": UnapplyCheckoutCouponResult,
"applyCheckoutSpamProtection": ApplyCheckoutSpamProtectionResult,
"addCheckoutShippingConsignments": AddCheckoutShippingConsignmentsResult,
"updateCheckoutShippingConsignment": UpdateCheckoutShippingConsignmentResult,
"deleteCheckoutConsignment": DeleteCheckoutConsignmentResult,
"completeCheckout": CompleteCheckoutResult
}
CheckoutPromotion
Description
The checkout promotion
Fields
| Field Name | Description |
|---|---|
banners - [CheckoutPromotionBanner!]!
|
The checkout promotion banners. |
Example
{"banners": [CheckoutPromotionBanner]}
CheckoutPromotionBanner
Description
The checkout promotion banner
Fields
| Field Name | Description |
|---|---|
entityId - Int!
|
The checkout promotion banner ID. |
type - CheckoutPromotionBannerType!
|
Type of the banner. |
locations - [CheckoutPromotionBannerLocation!]!
|
The list of the locations where the banner will display. |
text - String!
|
Text of the banner. |
Example
{
"entityId": 987,
"type": "APPLIED",
"locations": ["CART_PAGE"],
"text": "abc123"
}
CheckoutPromotionBannerLocation
Description
Checkout promotion banner location.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
Example
"CART_PAGE"
CheckoutPromotionBannerType
Description
Checkout promotion banner type.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
Example
"APPLIED"
CheckoutSelectedShippingOption
Description
Selected shipping option.
Fields
| Field Name | Description |
|---|---|
entityId - String!
|
Shipping option ID. |
description - String!
|
Shipping option description. |
type - String!
|
Shipping option type. Flat rate, UPS, etc. |
imageUrl - String
|
Shipping option image URL. |
cost - Money!
|
Shipping option cost. |
transitTime - String
|
An estimate of the arrival time. |
Example
{
"entityId": "xyz789",
"description": "abc123",
"type": "abc123",
"imageUrl": "xyz789",
"cost": Money,
"transitTime": "xyz789"
}
CheckoutSettings
Description
Checkout settings.
Fields
| Field Name | Description |
|---|---|
reCaptchaEnabled - Boolean!
|
Indicates whether ReCaptcha is enabled on checkout. |
Example
{"reCaptchaEnabled": true}
CheckoutShippingConsignment
Description
Checkout shipping consignment.
Fields
| Field Name | Description |
|---|---|
entityId - String!
|
Shipping consignment ID. |
address - CheckoutConsignmentAddress!
|
Shipping consignment address. |
availableShippingOptions - [CheckoutAvailableShippingOption!]
|
List of available shipping options. |
selectedShippingOption - CheckoutSelectedShippingOption
|
Selected shipping option. |
coupons - [CheckoutCoupon!]
|
List of coupons applied to this shipping consignment. |
shippingCost - Money
|
The shipping cost for the consignment. |
handlingCost - Money
|
The handling cost of shipping for the consignment. |
lineItemIds - [String!]!
|
List of line item IDs for the consignment. |
Example
{
"entityId": "xyz789",
"address": CheckoutConsignmentAddress,
"availableShippingOptions": [
CheckoutAvailableShippingOption
],
"selectedShippingOption": CheckoutSelectedShippingOption,
"coupons": [CheckoutCoupon],
"shippingCost": Money,
"handlingCost": Money,
"lineItemIds": ["xyz789"]
}
CheckoutShippingConsignmentInput
Description
Checkout shipping consignments input object
Fields
| Input Field | Description |
|---|---|
address - CheckoutAddressInput!
|
Shipping consignment address. |
lineItems - [CheckoutConsignmentLineItemInput!]!
|
List of line items for the consignment. |
Example
{
"address": CheckoutAddressInput,
"lineItems": [CheckoutConsignmentLineItemInput]
}
CheckoutTax
CollectionInfo
Description
Additional information about the collection.
Fields
| Field Name | Description |
|---|---|
totalItems - Long
|
Total items in the collection despite pagination. |
Example
{"totalItems": {}}
CompleteCheckoutInput
Description
Complete checkout input object
Fields
| Input Field | Description |
|---|---|
checkoutEntityId - String!
|
The checkout id |
Example
{"checkoutEntityId": "abc123"}
CompleteCheckoutResult
ContactField
Description
Contact field
Example
{
"address": "abc123",
"country": "abc123",
"addressType": "xyz789",
"email": "abc123",
"phone": "abc123"
}
ContactPage
Description
A contact page.
Fields
| Field Name | Description |
|---|---|
id - ID!
|
The ID of an object |
path - String!
|
The URL path of the page. |
htmlBody - String!
|
The body of the page. |
plainTextSummary - String!
|
The plain text summary of the page body. |
Arguments
|
|
contactFields - [String!]!
|
The contact fields that should be used on the page. |
renderedRegions - RenderedRegionsByPageType!
|
The rendered regions for the web page. |
entityId - Int!
|
Unique ID for the web page. |
parentEntityId - Int
|
Unique ID for the parent page. |
name - String!
|
Page name. |
isVisibleInNavigation - Boolean!
|
Whether or not the page should be visible in the navigation menu. |
seo - SeoDetails!
|
Page SEO details. |
Example
{
"id": 4,
"path": "xyz789",
"htmlBody": "abc123",
"plainTextSummary": "xyz789",
"contactFields": ["xyz789"],
"renderedRegions": RenderedRegionsByPageType,
"entityId": 123,
"parentEntityId": 987,
"name": "xyz789",
"isVisibleInNavigation": true,
"seo": SeoDetails
}
Content
Description
The page content.
Fields
| Field Name | Description |
|---|---|
renderedRegionsByPageType - RenderedRegionsByPageType!
|
The rendered regions by specific page. |
Arguments
|
|
renderedRegionsByPageTypeAndEntityId - RenderedRegionsByPageType!
|
The rendered regions by specific page and id. |
Arguments
|
|
pages - PageConnection!
|
Details of the pages. |
Arguments
|
|
page - WebPage
|
Page details. |
Arguments
|
|
blog - Blog
|
Blog details. |
banners - Banners
|
Banners details. |
Example
{
"renderedRegionsByPageType": RenderedRegionsByPageType,
"renderedRegionsByPageTypeAndEntityId": RenderedRegionsByPageType,
"pages": PageConnection,
"page": WebPage,
"blog": Blog,
"banners": Banners
}
CouponType
Description
The coupon type.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"FREE_SHIPPING"
CreateCartInput
Description
Create cart input object
Fields
| Input Field | Description |
|---|---|
lineItems - [CartLineItemInput!]
|
List of cart line items |
giftCertificates - [CartGiftCertificateInput!]
|
List of gift certificates |
currencyCode - String
|
ISO-4217 currency code |
locale - String
|
Locale of the cart |
Example
{
"lineItems": [CartLineItemInput],
"giftCertificates": [CartGiftCertificateInput],
"currencyCode": "abc123",
"locale": "abc123"
}
CreateCartMetafieldDataInput
CreateCartMetafieldError
Description
Error that occured as a result of createCartMetafieldMutation.
Types
| Union Types |
|---|
Example
NotFoundError
CreateCartMetafieldInput
Description
Input for create cart's metafield.
Fields
| Input Field | Description |
|---|---|
cartEntityId - String!
|
Cart id for which to create metafield. |
data - CreateCartMetafieldDataInput!
|
Create cart's metafield data. |
Example
{
"cartEntityId": "abc123",
"data": CreateCartMetafieldDataInput
}
CreateCartMetafieldResult
Description
Result of creating metafield for cart.
Fields
| Field Name | Description |
|---|---|
metafield - Metafields
|
Metafield created for cart. |
errors - [CreateCartMetafieldError!]!
|
Errors found during creation of cart's metafield. |
Example
{
"metafield": Metafields,
"errors": [NotFoundError]
}
CreateCartRedirectUrlsInput
Description
Create cart redirect URLs input object.
Fields
| Input Field | Description |
|---|---|
cartEntityId - String
|
The cart id to create the redirect URLs for. |
queryParams - [CreateCartRedirectUrlsQueryParamsInput!]
|
The query parameters to pass when redirecting to the URLs. |
Example
{
"cartEntityId": "abc123",
"queryParams": [CreateCartRedirectUrlsQueryParamsInput]
}
CreateCartRedirectUrlsQueryParamsInput
CreateCartRedirectUrlsResult
Description
Create cart redirect URLs result
Fields
| Field Name | Description |
|---|---|
redirectUrls - CartRedirectUrls
|
The redirect URLs created as a result of the mutation. |
Example
{"redirectUrls": CartRedirectUrls}
CreateCartResult
Description
Create cart result
Fields
| Field Name | Description |
|---|---|
cart - Cart
|
The Cart that is created as a result of mutation. |
Example
{"cart": Cart}
CreateWishlistInput
Description
Create wishlist input object
Fields
| Input Field | Description |
|---|---|
name - String!
|
A wishlist name |
isPublic - Boolean!
|
A wishlist visibility mode |
items - [WishlistItemInput!]
|
A wishlist items |
Example
{
"name": "xyz789",
"isPublic": false,
"items": [WishlistItemInput]
}
CreateWishlistResult
Description
Create wishlist
Fields
| Field Name | Description |
|---|---|
result - Wishlist!
|
The newly created wishlist |
Example
{"result": Wishlist}
Currency
Description
Currency details.
Fields
| Field Name | Description |
|---|---|
entityId - Int!
|
Currency ID. |
code - currencyCode!
|
Currency code. |
name - String!
|
Currency name. |
flagImage - String
|
Flag image URL. |
isActive - Boolean!
|
Indicates whether this currency is active. |
exchangeRate - Float!
|
Exchange rate relative to default currency. |
isTransactional - Boolean!
|
Indicates whether this currency is transactional. |
display - CurrencyDisplay!
|
Currency display settings. |
Example
{
"entityId": 987,
"code": "ADP",
"name": "xyz789",
"flagImage": "xyz789",
"isActive": true,
"exchangeRate": 123.45,
"isTransactional": true,
"display": CurrencyDisplay
}
CurrencyConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [CurrencyEdge!]
|
A list of edges. |
Example
{
"pageInfo": PageInfo,
"edges": [CurrencyEdge]
}
CurrencyDisplay
Description
Currency display settings.
Fields
| Field Name | Description |
|---|---|
symbol - String!
|
Currency symbol. |
symbolPlacement - CurrencySymbolPosition!
|
Currency symbol. |
decimalToken - String!
|
Currency decimal token. |
thousandsToken - String!
|
Currency thousands token. |
decimalPlaces - Int!
|
Currency decimal places. |
Example
{
"symbol": "xyz789",
"symbolPlacement": "LEFT",
"decimalToken": "abc123",
"thousandsToken": "xyz789",
"decimalPlaces": 987
}
CurrencyEdge
CurrencySymbolPosition
Description
Currency symbol position
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
Example
"LEFT"
CustomField
CustomFieldConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [CustomFieldEdge!]
|
A list of edges. |
Example
{
"pageInfo": PageInfo,
"edges": [CustomFieldEdge]
}
CustomFieldEdge
Description
An edge in a connection.
Fields
| Field Name | Description |
|---|---|
node - CustomField!
|
The item at the end of the edge. |
cursor - String!
|
A cursor for use in pagination. |
Example
{
"node": CustomField,
"cursor": "xyz789"
}
Customer
Description
A customer that shops on a store
Fields
| Field Name | Description |
|---|---|
entityId - Int!
|
The ID of the customer. |
company - String!
|
The company name of the customer. |
customerGroupId - Int!
|
The customer group id of the customer. |
email - String!
|
The email address of the customer. |
firstName - String!
|
The first name of the customer. |
lastName - String!
|
The last name of the customer. |
notes - String!
|
The notes of the customer. Notes aren't supported in Storefront GQL API. |
phone - String!
|
The phone number of the customer. |
taxExemptCategory - String!
|
The tax exempt category of the customer. |
addressCount - Int!
|
Customer addresses count. Use addresses.collectionInfo.totalItems instead. |
attributeCount - Int!
|
Customer attributes count. |
storeCredit - [Money!]!
|
Customer store credit. |
attributes - CustomerAttributes!
|
Customer attributes. |
wishlists - WishlistConnection!
|
Customer wishlists. |
Arguments
|
|
metafields - MetafieldConnection!
|
Metafield data related to a customer. |
formFields - [CustomerFormFieldValue!]!
|
The form field values of the customer. |
addresses - AddressConnection!
|
Customer addresses. |
Example
{
"entityId": 987,
"company": "xyz789",
"customerGroupId": 987,
"email": "xyz789",
"firstName": "xyz789",
"lastName": "abc123",
"notes": "abc123",
"phone": "abc123",
"taxExemptCategory": "abc123",
"addressCount": 123,
"attributeCount": 987,
"storeCredit": [Money],
"attributes": CustomerAttributes,
"wishlists": WishlistConnection,
"metafields": MetafieldConnection,
"formFields": [CustomerFormFieldValue],
"addresses": AddressConnection
}
CustomerAddress
Description
Address that is associated with a customer account.
Fields
| Field Name | Description |
|---|---|
entityId - Int!
|
Customer address ID. |
firstName - String!
|
First name of the address owner. |
lastName - String!
|
Last name of the address owner. |
address1 - String!
|
First line for the street address. |
address2 - String
|
Second line for the street address. |
city - String!
|
City. |
countryCode - String!
|
2-letter country code. |
stateOrProvince - String
|
Name of State or Province. |
phone - String
|
Phone number. |
postalCode - String
|
Postal code. |
company - String
|
Company name associated with the address. |
formFields - [CustomerFormFieldValue!]!
|
The form field values of the customer address. |
Example
{
"entityId": 123,
"firstName": "xyz789",
"lastName": "abc123",
"address1": "abc123",
"address2": "xyz789",
"city": "abc123",
"countryCode": "abc123",
"stateOrProvince": "abc123",
"phone": "xyz789",
"postalCode": "xyz789",
"company": "xyz789",
"formFields": [CustomerFormFieldValue]
}
CustomerAddressCreationError
Description
Unexpected error while creating a customer address.
Fields
| Field Name | Description |
|---|---|
message - String!
|
Error message. |
Example
{"message": "abc123"}
CustomerAddressDeletionError
Description
Unexpected error while deleting a customer address.
Fields
| Field Name | Description |
|---|---|
message - String!
|
Error message. |
Example
{"message": "abc123"}
CustomerAddressUpdateError
Description
An unexpected error while updating an address for a customer.
Fields
| Field Name | Description |
|---|---|
message - String!
|
Error message. |
Example
{"message": "xyz789"}
CustomerAttribute
Description
A custom, store-specific attribute for a customer
Example
{
"entityId": 123,
"value": "abc123",
"name": "xyz789"
}
CustomerAttributes
Description
Custom, store-specific customer attributes
Fields
| Field Name | Description |
|---|---|
attribute - CustomerAttribute!
|
A custom, store-specific attribute for a customer |
Arguments
|
|
Example
{"attribute": CustomerAttribute}
CustomerDoesNotExistError
Description
An error due to customer not existing when attempting to update customer information.
Fields
| Field Name | Description |
|---|---|
message - String!
|
Error message. |
Example
{"message": "abc123"}
CustomerFormFieldValue
Description
Custom form field value as submitted by customer.
Fields
| Field Name | Description |
|---|---|
entityId - Int!
|
Entity ID of a custom form field value on a customer or customer address. |
name - String!
|
The name of the form field that the value is for. |
Possible Types
| CustomerFormFieldValue Types |
|---|
Example
{"entityId": 987, "name": "xyz789"}
CustomerFormFieldsInput
Description
The input for the filled out customer form fields.
Fields
| Input Field | Description |
|---|---|
checkboxes - [CheckboxesFormFieldInput!]
|
List of checkboxes custom form fields input. |
multipleChoices - [MultipleChoiceFormFieldInput!]
|
List of multiple choice custom form fields input. This includes pick lists. |
numbers - [NumberFormFieldInput!]
|
List of number custom form fields input. |
dates - [DateFormFieldInput!]
|
List of date custom form fields input. |
texts - [TextFormFieldInput!]
|
List of text custom form fields input. |
passwords - [PasswordFormFieldInput!]
|
List of password custom form fields input. |
Example
{
"checkboxes": [CheckboxesFormFieldInput],
"multipleChoices": [MultipleChoiceFormFieldInput],
"numbers": [NumberFormFieldInput],
"dates": [DateFormFieldInput],
"texts": [TextFormFieldInput],
"passwords": [PasswordFormFieldInput]
}
CustomerMutations
Description
Mutations for customers domain.
Fields
| Field Name | Description |
|---|---|
changePassword - ChangePasswordResult!
|
Change the password for a customer. |
Arguments
|
|
requestResetPassword - RequestResetPasswordResult!
|
Request reset password email. |
Arguments
|
|
resetPassword - ResetPasswordResult!
|
Reset customer password |
Arguments
|
|
registerCustomer - RegisterCustomerResult!
|
Register a new customer. |
Arguments
|
|
updateCustomer - UpdateCustomerResult!
|
Update a customer. |
Arguments
|
|
addCustomerAddress - AddCustomerAddressResult!
|
Submit a customer address. |
Arguments
|
|
updateCustomerAddress - UpdateCustomerAddressResult!
|
Update a customer address. |
Arguments
|
|
deleteCustomerAddress - DeleteCustomerAddressResult!
|
Delete a customer address. |
Arguments
|
|
Example
{
"changePassword": ChangePasswordResult,
"requestResetPassword": RequestResetPasswordResult,
"resetPassword": ResetPasswordResult,
"registerCustomer": RegisterCustomerResult,
"updateCustomer": UpdateCustomerResult,
"addCustomerAddress": AddCustomerAddressResult,
"updateCustomerAddress": UpdateCustomerAddressResult,
"deleteCustomerAddress": DeleteCustomerAddressResult
}
CustomerNotLoggedInError
Description
An error due to not supplying a customer ID either via customer-id header (when using a customer impersonation token) or by logging into the storefront as a customer.
Fields
| Field Name | Description |
|---|---|
message - String!
|
Error message. |
Example
{"message": "xyz789"}
CustomerPasswordError
Description
An error that occurred when a customer password is being changed or reset.
Fields
| Field Name | Description |
|---|---|
message - String!
|
Details of the error. |
Example
{"message": "abc123"}
CustomerRegistrationError
Description
An unexpected error while registering a customer.
Fields
| Field Name | Description |
|---|---|
message - String!
|
A description of the error. |
Example
{"message": "abc123"}
DateFieldOption
Description
A calendar for allowing selection of a date.
Fields
| Field Name | Description |
|---|---|
defaultValue - DateTime
|
The default timestamp of date option. |
earliest - DateTime
|
The earliest timestamp of date option. |
latest - DateTime
|
The latest timestamp of date option. |
limitDateBy - LimitDateOption!
|
Limit date by |
entityId - Int!
|
Unique ID for the option. |
displayName - String!
|
Display name for the option. |
isRequired - Boolean!
|
One of the option values is required to be selected for the checkout. |
isVariantOption - Boolean!
|
Indicates whether it is a variant option or modifier. |
Example
{
"defaultValue": "2007-12-03T10:15:30Z",
"earliest": "2007-12-03T10:15:30Z",
"latest": "2007-12-03T10:15:30Z",
"limitDateBy": "EARLIEST_DATE",
"entityId": 123,
"displayName": "abc123",
"isRequired": true,
"isVariantOption": false
}
DateFormField
Description
Date form field.
Fields
| Field Name | Description |
|---|---|
defaultDate - DateTime
|
The default date value for the form field. |
minDate - DateTime
|
The earliest date that can be selected for the form field. |
maxDate - DateTime
|
The latest date that can be selected for the form field. |
entityId - Int!
|
The entity ID of the form field. |
label - String!
|
The label to display for the form field. |
sortOrder - Int!
|
The sort order priority of the form field. |
isBuiltIn - Boolean!
|
Indicates whether the form field is built-in. |
isRequired - Boolean!
|
Indicates whether the form field is required. |
Example
{
"defaultDate": "2007-12-03T10:15:30Z",
"minDate": "2007-12-03T10:15:30Z",
"maxDate": "2007-12-03T10:15:30Z",
"entityId": 123,
"label": "abc123",
"sortOrder": 123,
"isBuiltIn": true,
"isRequired": true
}
DateFormFieldInput
DateFormFieldValue
Description
Date custom form field value.
Fields
| Field Name | Description |
|---|---|
date - DateTimeExtended!
|
The date submitted by a customer. |
entityId - Int!
|
Entity ID of a custom form field value on a customer or customer address. |
name - String!
|
The name of the form field that the value is for. |
Example
{
"date": DateTimeExtended,
"entityId": 987,
"name": "xyz789"
}
DateTime
Description
ISO-8601 formatted date in UTC. (e.g. 2024-01-01T00:00:00Z)
Example
"2007-12-03T10:15:30Z"
DateTimeExtended
Description
Date Time Extended
Fields
| Field Name | Description |
|---|---|
utc - DateTime!
|
ISO-8601 formatted date in UTC. (e.g. 2024-01-01T00:00:00Z) |
Example
{"utc": "2007-12-03T10:15:30Z"}
DeleteCartInput
Description
Delete cart input object
Fields
| Input Field | Description |
|---|---|
cartEntityId - String!
|
The cart id |
Example
{"cartEntityId": "xyz789"}
DeleteCartLineItemInput
DeleteCartLineItemResult
Description
Delete cart lien item result
Example
{
"deletedLineItemEntityId": "abc123",
"cart": Cart,
"deletedCartEntityId": "xyz789"
}
DeleteCartMetafieldError
Description
Error that occured as a result of deleteCartMetafield mutation.
Types
| Union Types |
|---|
Example
NotFoundError
DeleteCartMetafieldInput
DeleteCartMetafieldResult
Description
Result of deleting metafield for cart.
Fields
| Field Name | Description |
|---|---|
deletedMetafieldEntityId - Int
|
Id of metafield deleted for cart. |
errors - [DeleteCartMetafieldError!]!
|
Errors found during deletion of cart's metafield. |
Example
{
"deletedMetafieldEntityId": 123,
"errors": [NotFoundError]
}
DeleteCartResult
Description
Delete cart result
Fields
| Field Name | Description |
|---|---|
deletedCartEntityId - String
|
The ID of the Cart that is deleted as a result of mutation. |
Example
{"deletedCartEntityId": "abc123"}
DeleteCheckoutConsignmentInput
DeleteCheckoutConsignmentResult
Description
Delete checkout consignment result
Fields
| Field Name | Description |
|---|---|
checkout - Checkout
|
The Checkout that is updated as a result of mutation. |
Example
{"checkout": Checkout}
DeleteCustomerAddressError
Description
Possible response errors when attempting to delete a customer address.
Types
| Union Types |
|---|
Example
CustomerNotLoggedInError
DeleteCustomerAddressInput
Description
Input for deleting a customer address.
Fields
| Input Field | Description |
|---|---|
addressEntityId - Int!
|
Address entity ID for the customer address to delete. |
Example
{"addressEntityId": 987}
DeleteCustomerAddressResult
Description
Result of DeleteCustomerAddress mutation.
Fields
| Field Name | Description |
|---|---|
errors - [DeleteCustomerAddressError!]!
|
Response errors that occurred while attempting to delete a customer address. |
Example
{"errors": [CustomerNotLoggedInError]}
DeleteWishlistItemsInput
DeleteWishlistItemsResult
Description
Delete wishlist items
Fields
| Field Name | Description |
|---|---|
result - Wishlist!
|
The wishlist |
Example
{"result": Wishlist}
DeleteWishlistResult
Description
Delete wishlist
Fields
| Field Name | Description |
|---|---|
result - String!
|
The result of the operation |
Example
{"result": "xyz789"}
DeleteWishlistsInput
Description
Delete wishlists input object
Fields
| Input Field | Description |
|---|---|
entityIds - [Int!]!
|
The wishlist ids |
Example
{"entityIds": [987]}
DisplayField
Distance
Description
Distance
Fields
| Field Name | Description |
|---|---|
value - Float!
|
Distance in specified length unit |
lengthUnit - LengthUnit!
|
Length unit |
Example
{"value": 123.45, "lengthUnit": "Kilometres"}
DistanceFilter
Description
Filter locations by the distance
Fields
| Input Field | Description |
|---|---|
radius - Float!
|
Radius of search in length units specified in lengthUnit argument |
longitude - Float!
|
Signed decimal degrees without compass direction |
latitude - Float!
|
Signed decimal degrees without compass direction |
lengthUnit - LengthUnit!
|
Length unit |
Example
{
"radius": 987.65,
"longitude": 123.45,
"latitude": 123.45,
"lengthUnit": "Kilometres"
}
EmailAlreadyInUseError
Description
An error due to the customer email already being in use when attempting registration.
Fields
| Field Name | Description |
|---|---|
message - String!
|
A description of the error. |
Example
{"message": "xyz789"}
EntityPageType
Description
Entity page type
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"BLOG_POST"
Error
Description
An error object, indicating what went wrong with a mutation.
Fields
| Field Name | Description |
|---|---|
message - String!
|
A description of the error |
Possible Types
| Error Types |
|---|
Example
{"message": "xyz789"}
ExternalLinkPage
Description
An external link page.
Fields
| Field Name | Description |
|---|---|
link - String!
|
The URL that the page links to. |
entityId - Int!
|
Unique ID for the web page. |
parentEntityId - Int
|
Unique ID for the parent page. |
name - String!
|
Page name. |
isVisibleInNavigation - Boolean!
|
Whether or not the page should be visible in the navigation menu. |
seo - SeoDetails!
|
Page SEO details. |
Example
{
"link": "abc123",
"entityId": 123,
"parentEntityId": 123,
"name": "xyz789",
"isVisibleInNavigation": false,
"seo": SeoDetails
}
FileUploadFieldOption
Description
A form allowing selection and uploading of a file from the user's local computer.
Fields
| Field Name | Description |
|---|---|
maxFileSize - Int!
|
The maximum size of the file in kilobytes |
fileTypes - [String!]!
|
All possible file extensions. Empty means that all files allowed. |
entityId - Int!
|
Unique ID for the option. |
displayName - String!
|
Display name for the option. |
isRequired - Boolean!
|
One of the option values is required to be selected for the checkout. |
isVariantOption - Boolean!
|
Indicates whether it is a variant option or modifier. |
Example
{
"maxFileSize": 123,
"fileTypes": ["abc123"],
"entityId": 987,
"displayName": "abc123",
"isRequired": false,
"isVariantOption": true
}
Float
Description
The Float scalar type represents signed double-precision fractional values as specified by IEEE 754.
Example
123.45
FormField
Description
The details of a form field.
Fields
| Field Name | Description |
|---|---|
entityId - Int!
|
The entity ID of the form field. |
label - String!
|
The label to display for the form field. |
sortOrder - Int!
|
The sort order priority of the form field. |
isBuiltIn - Boolean!
|
Indicates whether the form field is built-in. |
isRequired - Boolean!
|
Indicates whether the form field is required. |
Example
{
"entityId": 123,
"label": "xyz789",
"sortOrder": 987,
"isBuiltIn": false,
"isRequired": false
}
FormFieldFiltersInput
Description
Object containing filters for querying form fields.
Example
{"entityIds": [123], "isRequired": true, "isBuiltIn": true}
FormFieldOption
FormFieldSortInput
Description
The sorting to use on form field results.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
Example
"FIELD_ID"
FormFields
Description
The types of form fields that can be queried.
Fields
| Field Name | Description |
|---|---|
customer - [FormField!]!
|
The customer form fields. |
Arguments
|
|
shippingAddress - [FormField!]!
|
The shipping address form fields. |
Arguments
|
|
billingAddress - [FormField!]!
|
The billing address form fields. |
Arguments
|
|
Example
{
"customer": [FormField],
"shippingAddress": [FormField],
"billingAddress": [FormField]
}
GiftWrapping
Description
Gift wrapping for product
Example
{
"entityId": 987,
"name": "xyz789",
"allowComments": true,
"previewImageUrl": "xyz789"
}
GiftWrappingConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [GiftWrappingEdge!]
|
A list of edges. |
Example
{
"pageInfo": PageInfo,
"edges": [GiftWrappingEdge]
}
GiftWrappingEdge
Description
An edge in a connection.
Fields
| Field Name | Description |
|---|---|
node - GiftWrapping!
|
The item at the end of the edge. |
cursor - String!
|
A cursor for use in pagination. |
Example
{
"node": GiftWrapping,
"cursor": "abc123"
}
ID
Description
The ID scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "4") or integer (such as 4) input value will be accepted as an ID.
Example
"4"
Image
Description
Image
Fields
| Field Name | Description |
|---|---|
url - String!
|
Absolute path to image using store CDN. |
urlOriginal - String!
|
Absolute path to original image using store CDN. |
urlTemplate - String!
|
A templatized URL containing a {:size} parameter which can be replaced with a string specifying the desired image size in either inherent width (123w) or width and height (123x123). |
altText - String!
|
Text description of an image that can be used for SEO and/or accessibility purposes. |
isDefault - Boolean!
|
Indicates whether this is the primary image. |
Example
{
"url": "xyz789",
"urlOriginal": "abc123",
"urlTemplate": "abc123",
"altText": "xyz789",
"isDefault": true
}
ImageConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [ImageEdge!]
|
A list of edges. |
Example
{
"pageInfo": PageInfo,
"edges": [ImageEdge]
}
ImageEdge
Int
Description
The Int scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.
Example
987
Inventory
Description
An inventory
Fields
| Field Name | Description |
|---|---|
locations - InventoryLocationConnection!
|
Locations |
Arguments
|
|
Example
{"locations": InventoryLocationConnection}
InventoryAddress
Description
Address
Fields
| Field Name | Description |
|---|---|
entityId - Int!
|
Address id. |
code - String!
|
Address code. |
label - String!
|
Address label. |
description - String
|
Address description. |
address1 - String!
|
Address line1. |
address2 - String!
|
Address line2. |
city - String!
|
Address city. |
stateOrProvince - String!
|
Address state. |
countryCode - String!
|
Country code. |
postalCode - String!
|
Address zip. |
phone - String!
|
Address phone. |
email - String!
|
Address email. |
latitude - Float
|
Address latitude. |
longitude - Float
|
Address longitude. |
Example
{
"entityId": 123,
"code": "xyz789",
"label": "xyz789",
"description": "abc123",
"address1": "xyz789",
"address2": "xyz789",
"city": "xyz789",
"stateOrProvince": "xyz789",
"countryCode": "abc123",
"postalCode": "xyz789",
"phone": "abc123",
"email": "xyz789",
"latitude": 123.45,
"longitude": 123.45
}
InventoryByLocations
Description
Inventory By Locations
Fields
| Field Name | Description |
|---|---|
locationEntityId - Long!
|
Location id. |
availableToSell - Long!
|
Number of available products in stock. |
warningLevel - Int!
|
Indicates a threshold low-stock level. |
isInStock - Boolean!
|
Indicates whether this product is in stock. |
locationDistance - Distance
|
Distance between location and specified longitude and latitude |
locationEntityTypeId - String
|
Location type id. |
locationEntityServiceTypeIds - [String!]!
|
Location service type ids. Deprecated. Will be substituted with pickup methods. |
locationEntityCode - String!
|
Location code. |
Example
{
"locationEntityId": {},
"availableToSell": {},
"warningLevel": 123,
"isInStock": false,
"locationDistance": Distance,
"locationEntityTypeId": "xyz789",
"locationEntityServiceTypeIds": [
"xyz789"
],
"locationEntityCode": "xyz789"
}
InventoryLocation
Description
Location
Fields
| Field Name | Description |
|---|---|
entityId - Int!
|
Location id. |
code - String!
|
Location code. |
label - String!
|
Location label. |
description - String
|
Location description. |
typeId - String
|
Location type id. |
serviceTypeIds - [String!]!
|
Location service type ids. Deprecated. Will be substituted with pickup methods. |
address - InventoryAddress
|
Location address |
operatingHours - OperatingHours
|
Location OperatingHours |
distance - Distance
|
Distance between location and specified longitude and latitude |
blackoutHours - [SpecialHour!]!
|
Upcoming events Deprecated. Use specialHours instead |
specialHours - [SpecialHour!]!
|
Upcoming events |
timeZone - String
|
Time zone of location |
metafields - MetafieldConnection!
|
Metafield data related to a location. |
Example
{
"entityId": 987,
"code": "abc123",
"label": "abc123",
"description": "abc123",
"typeId": "xyz789",
"serviceTypeIds": ["xyz789"],
"address": InventoryAddress,
"operatingHours": OperatingHours,
"distance": Distance,
"blackoutHours": [SpecialHour],
"specialHours": [SpecialHour],
"timeZone": "xyz789",
"metafields": MetafieldConnection
}
InventoryLocationConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [InventoryLocationEdge!]
|
A list of edges. |
Example
{
"pageInfo": PageInfo,
"edges": [InventoryLocationEdge]
}
InventoryLocationEdge
Description
An edge in a connection.
Fields
| Field Name | Description |
|---|---|
node - InventoryLocation!
|
The item at the end of the edge. |
cursor - String!
|
A cursor for use in pagination. |
Example
{
"node": InventoryLocation,
"cursor": "xyz789"
}
InventorySettings
Description
Inventory settings from control panel.
Fields
| Field Name | Description |
|---|---|
productOutOfStockBehavior - ProductOutOfStockBehavior
|
The product out of stock behavior. |
optionOutOfStockBehavior - OptionOutOfStockBehavior
|
The option out of stock behavior. |
stockLevelDisplay - StockLevelDisplay
|
Hide or show inventory node for product |
defaultOutOfStockMessage - String!
|
Out of stock message. |
hideInProductFiltering - Boolean!
|
Flag to show or not on product filtering when option is out of stock |
showPreOrderStockLevels - Boolean!
|
Show pre-order inventory |
showOutOfStockMessage - Boolean!
|
Show out of stock message on product listing pages |
updateStockBehavior - UpdateStockBehavior
|
The behavior to use to update stock levels. |
Example
{
"productOutOfStockBehavior": "DO_NOTHING",
"optionOutOfStockBehavior": "DO_NOTHING",
"stockLevelDisplay": "DONT_SHOW",
"defaultOutOfStockMessage": "abc123",
"hideInProductFiltering": true,
"showPreOrderStockLevels": false,
"showOutOfStockMessage": true,
"updateStockBehavior": "ORDER_COMPLETED_OR_SHIPPED"
}
LengthUnit
Description
length unit
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
Example
"Kilometres"
LimitDateOption
Description
Limit date by
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
Example
"EARLIEST_DATE"
LimitExceededError
LimitInputBy
Description
Limit numbers by several options.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
Example
"HIGHEST_VALUE"
LocationConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [LocationEdge!]
|
A list of edges. |
Example
{
"pageInfo": PageInfo,
"edges": [LocationEdge]
}
LocationEdge
Description
An edge in a connection.
Fields
| Field Name | Description |
|---|---|
node - InventoryByLocations!
|
The item at the end of the edge. |
cursor - String!
|
A cursor for use in pagination. |
Example
{
"node": InventoryByLocations,
"cursor": "xyz789"
}
LoginResult
LogoField
LogoutResult
Description
Logout result
Fields
| Field Name | Description |
|---|---|
result - String!
|
The result of a logout |
Example
{"result": "abc123"}
Long
Description
The Long scalar type represents non-fractional signed whole numeric values. Long can represent values between -(2^63) and 2^63 - 1.
Example
{}
ManualRedirect
Description
Redirect to manually input url.
Fields
| Field Name | Description |
|---|---|
url - String!
|
Url. |
Example
{"url": "abc123"}
Measurement
MetafieldConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [MetafieldEdge!]
|
A list of edges. |
Example
{
"pageInfo": PageInfo,
"edges": [MetafieldEdge]
}
MetafieldEdge
Description
An edge in a connection.
Fields
| Field Name | Description |
|---|---|
node - Metafields!
|
The item at the end of the edge. |
cursor - String!
|
A cursor for use in pagination. |
Example
{
"node": Metafields,
"cursor": "xyz789"
}
Metafields
Description
Key/Value pairs of data attached tied to a resource entity (product, brand, category, etc.)
Example
{
"id": 4,
"entityId": 987,
"key": "abc123",
"value": "abc123"
}
Money
Description
A money object - includes currency code and a money amount
Fields
| Field Name | Description |
|---|---|
currencyCode - String!
|
Currency code of the current money. |
value - BigDecimal!
|
The amount of money. |
formatted - String
|
The formatted currency string for the current money. Deprecated. Don't use - it will be removed soon. |
Example
{
"currencyCode": "xyz789",
"value": BigDecimal,
"formatted": "abc123"
}
MoneyRange
MultiLineTextFieldOption
Description
A multi-line text input field, aka a text box.
Fields
| Field Name | Description |
|---|---|
defaultValue - String
|
Default value of the multiline text field option. |
minLength - Int
|
The minimum number of characters. |
maxLength - Int
|
The maximum number of characters. |
maxLines - Int
|
The maximum number of lines. |
entityId - Int!
|
Unique ID for the option. |
displayName - String!
|
Display name for the option. |
isRequired - Boolean!
|
One of the option values is required to be selected for the checkout. |
isVariantOption - Boolean!
|
Indicates whether it is a variant option or modifier. |
Example
{
"defaultValue": "abc123",
"minLength": 123,
"maxLength": 123,
"maxLines": 987,
"entityId": 987,
"displayName": "abc123",
"isRequired": false,
"isVariantOption": true
}
MultilineTextFormField
Description
Multiline text form field.
Fields
| Field Name | Description |
|---|---|
defaultText - String
|
The default text value for the form field. |
rows - Int!
|
The amount of rows for the form field. |
entityId - Int!
|
The entity ID of the form field. |
label - String!
|
The label to display for the form field. |
sortOrder - Int!
|
The sort order priority of the form field. |
isBuiltIn - Boolean!
|
Indicates whether the form field is built-in. |
isRequired - Boolean!
|
Indicates whether the form field is required. |
Example
{
"defaultText": "xyz789",
"rows": 123,
"entityId": 123,
"label": "abc123",
"sortOrder": 987,
"isBuiltIn": false,
"isRequired": true
}
MultipleChoiceFormFieldInput
MultipleChoiceFormFieldValue
Description
Multiple choice (includes radio button and pick list) custom form field result.
Fields
| Field Name | Description |
|---|---|
valueEntityId - Int!
|
The multiple choice value id selected by customer. |
value - String!
|
The multiple choice value selected by customer. |
entityId - Int!
|
Entity ID of a custom form field value on a customer or customer address. |
name - String!
|
The name of the form field that the value is for. |
Example
{
"valueEntityId": 987,
"value": "xyz789",
"entityId": 987,
"name": "xyz789"
}
MultipleChoiceOption
Description
An option type that has a fixed list of values.
Fields
| Field Name | Description |
|---|---|
displayStyle - String!
|
The chosen display style for this multiple choice option. |
values - ProductOptionValueConnection!
|
List of option values. |
entityId - Int!
|
Unique ID for the option. |
displayName - String!
|
Display name for the option. |
isRequired - Boolean!
|
One of the option values is required to be selected for the checkout. |
isVariantOption - Boolean!
|
Indicates whether it is a variant option or modifier. |
Example
{
"displayStyle": "xyz789",
"values": ProductOptionValueConnection,
"entityId": 987,
"displayName": "abc123",
"isRequired": true,
"isVariantOption": false
}
MultipleChoiceOptionValue
Description
A simple multiple choice value comprised of an id and a label.
Fields
| Field Name | Description |
|---|---|
entityId - Int!
|
Unique ID for the option value. |
label - String!
|
Label for the option value. |
isDefault - Boolean!
|
Indicates whether this value is the chosen default selected value. |
isSelected - Boolean
|
Indicates whether this value is selected based on sku/variantEntityId/optionValueIds overlay requested on the product node level. |
Example
{
"entityId": 123,
"label": "abc123",
"isDefault": true,
"isSelected": false
}
Node
Description
An object with an ID
Fields
| Field Name | Description |
|---|---|
id - ID!
|
The id of the object. |
Possible Types
| Node Types |
|---|
Example
{"id": "4"}
NormalPage
Description
A normal page.
Fields
| Field Name | Description |
|---|---|
id - ID!
|
The ID of an object |
path - String!
|
The URL path of the page. |
htmlBody - String!
|
The body of the page. |
plainTextSummary - String!
|
The plain text summary of the page body. |
Arguments
|
|
renderedRegions - RenderedRegionsByPageType!
|
The rendered regions for the web page. |
entityId - Int!
|
Unique ID for the web page. |
parentEntityId - Int
|
Unique ID for the parent page. |
name - String!
|
Page name. |
isVisibleInNavigation - Boolean!
|
Whether or not the page should be visible in the navigation menu. |
seo - SeoDetails!
|
Page SEO details. |
Example
{
"id": "4",
"path": "abc123",
"htmlBody": "xyz789",
"plainTextSummary": "abc123",
"renderedRegions": RenderedRegionsByPageType,
"entityId": 987,
"parentEntityId": 987,
"name": "abc123",
"isVisibleInNavigation": false,
"seo": SeoDetails
}
NotAuthorisedError
Description
The not authorized to perform operation error.
Fields
| Field Name | Description |
|---|---|
message - String!
|
A description of the error |
Example
{"message": "xyz789"}
NotFoundError
Description
Subject not found error.
Fields
| Field Name | Description |
|---|---|
message - String!
|
A description of the error |
Example
{"message": "xyz789"}
NumberFieldOption
Description
A single line text input field that only accepts numbers.
Fields
| Field Name | Description |
|---|---|
defaultValue - Float
|
Default value of the text field option. |
lowest - Float
|
The bottom limit of possible numbers. |
highest - Float
|
The top limit of possible numbers. |
isIntegerOnly - Boolean!
|
Allow whole numbers only. |
limitNumberBy - LimitInputBy!
|
Limit numbers by several options. |
entityId - Int!
|
Unique ID for the option. |
displayName - String!
|
Display name for the option. |
isRequired - Boolean!
|
One of the option values is required to be selected for the checkout. |
isVariantOption - Boolean!
|
Indicates whether it is a variant option or modifier. |
Example
{
"defaultValue": 987.65,
"lowest": 987.65,
"highest": 987.65,
"isIntegerOnly": false,
"limitNumberBy": "HIGHEST_VALUE",
"entityId": 987,
"displayName": "abc123",
"isRequired": false,
"isVariantOption": true
}
NumberFormField
Description
Number only form field.
Fields
| Field Name | Description |
|---|---|
defaultNumber - Float
|
The default number value for the form field. |
maxLength - Int
|
The maximum amount of characters that can be entered into text form field. |
minNumber - Int
|
The lowest allowed number to be entered in the form field. |
maxNumber - Int
|
The highest allowed number to be entered in the form field. |
entityId - Int!
|
The entity ID of the form field. |
label - String!
|
The label to display for the form field. |
sortOrder - Int!
|
The sort order priority of the form field. |
isBuiltIn - Boolean!
|
Indicates whether the form field is built-in. |
isRequired - Boolean!
|
Indicates whether the form field is required. |
Example
{
"defaultNumber": 123.45,
"maxLength": 123,
"minNumber": 123,
"maxNumber": 987,
"entityId": 123,
"label": "abc123",
"sortOrder": 987,
"isBuiltIn": false,
"isRequired": true
}
NumberFormFieldInput
NumberFormFieldValue
Description
Numbers custom form field value.
Example
{
"number": 123.45,
"entityId": 987,
"name": "xyz789"
}
OperatingDay
OperatingHours
Description
Operating hours
Fields
| Field Name | Description |
|---|---|
sunday - OperatingDay
|
Sunday. |
monday - OperatingDay
|
Monday. |
tuesday - OperatingDay
|
Tuesday. |
wednesday - OperatingDay
|
Wednesday. |
thursday - OperatingDay
|
Thursday. |
friday - OperatingDay
|
Friday. |
saturday - OperatingDay
|
Saturday. |
Example
{
"sunday": OperatingDay,
"monday": OperatingDay,
"tuesday": OperatingDay,
"wednesday": OperatingDay,
"thursday": OperatingDay,
"friday": OperatingDay,
"saturday": OperatingDay
}
OptionConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [OptionEdge!]
|
A list of edges. |
Example
{
"pageInfo": PageInfo,
"edges": [OptionEdge]
}
OptionEdge
Description
An edge in a connection.
Fields
| Field Name | Description |
|---|---|
node - ProductOption!
|
The item at the end of the edge. |
cursor - String!
|
A cursor for use in pagination. |
Example
{
"node": ProductOption,
"cursor": "xyz789"
}
OptionOutOfStockBehavior
Description
Behavior of the variant when stock is equal to 0
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
Example
"DO_NOTHING"
OptionValueConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [OptionValueEdge!]
|
A list of edges. |
Example
{
"pageInfo": PageInfo,
"edges": [OptionValueEdge]
}
OptionValueEdge
Description
An edge in a connection.
Fields
| Field Name | Description |
|---|---|
node - ProductOptionValue!
|
The item at the end of the edge. |
cursor - String!
|
A cursor for use in pagination. |
Example
{
"node": ProductOptionValue,
"cursor": "xyz789"
}
OptionValueId
Order
Description
The order.
Fields
| Field Name | Description |
|---|---|
entityId - Int!
|
Order ID. |
Example
{"entityId": 987}
OtherSearchFilter
Description
Other Filter
Fields
| Field Name | Description |
|---|---|
displayProductCount - Boolean!
|
Indicates whether to display product count next to the filter. |
freeShipping - OtherSearchFilterItem
|
Free shipping filter. |
isFeatured - OtherSearchFilterItem
|
Is Featured filter. |
isInStock - OtherSearchFilterItem
|
Is In Stock filter. |
name - String!
|
Display name for the filter. |
isCollapsedByDefault - Boolean!
|
Indicates whether filter is collapsed by default. |
Example
{
"displayProductCount": true,
"freeShipping": OtherSearchFilterItem,
"isFeatured": OtherSearchFilterItem,
"isInStock": OtherSearchFilterItem,
"name": "xyz789",
"isCollapsedByDefault": true
}
OtherSearchFilterItem
PageConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [PageEdge!]
|
A list of edges. |
Example
{
"pageInfo": PageInfo,
"edges": [PageEdge]
}
PageEdge
PageInfo
Description
Information about pagination in a connection.
Fields
| Field Name | Description |
|---|---|
hasNextPage - Boolean!
|
When paginating forwards, are there more items? |
hasPreviousPage - Boolean!
|
When paginating backwards, are there more items? |
startCursor - String
|
When paginating backwards, the cursor to continue. |
endCursor - String
|
When paginating forwards, the cursor to continue. |
Example
{
"hasNextPage": true,
"hasPreviousPage": false,
"startCursor": "abc123",
"endCursor": "xyz789"
}
PageRedirect
PageType
Description
Page type
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"ACCOUNT_ADDRESS"
PasswordFormField
Description
Password form field.
Fields
| Field Name | Description |
|---|---|
defaultText - String
|
The default text value for the form field. |
maxLength - Int
|
The maximum amount of characters that can be entered into the form field. |
entityId - Int!
|
The entity ID of the form field. |
label - String!
|
The label to display for the form field. |
sortOrder - Int!
|
The sort order priority of the form field. |
isBuiltIn - Boolean!
|
Indicates whether the form field is built-in. |
isRequired - Boolean!
|
Indicates whether the form field is required. |
Example
{
"defaultText": "abc123",
"maxLength": 987,
"entityId": 987,
"label": "xyz789",
"sortOrder": 123,
"isBuiltIn": false,
"isRequired": true
}
PasswordFormFieldInput
PasswordFormFieldValue
Description
Password custom form field value.
Example
{
"password": "xyz789",
"entityId": 987,
"name": "xyz789"
}
PicklistFormField
Description
Pick list form field. Similar to Radio Buttons, but should be rendered as a dropdown select.
Fields
| Field Name | Description |
|---|---|
choosePrefix - String!
|
The text to display before a user has made a selection. |
options - [FormFieldOption!]!
|
The options for the form field. |
entityId - Int!
|
The entity ID of the form field. |
label - String!
|
The label to display for the form field. |
sortOrder - Int!
|
The sort order priority of the form field. |
isBuiltIn - Boolean!
|
Indicates whether the form field is built-in. |
isRequired - Boolean!
|
Indicates whether the form field is required. |
Example
{
"choosePrefix": "abc123",
"options": [FormFieldOption],
"entityId": 987,
"label": "xyz789",
"sortOrder": 987,
"isBuiltIn": true,
"isRequired": false
}
PicklistOrTextFormField
Description
Pick list or text form field. This field can either be rendered as text or a dropdown and is used for the State/Province field.
Fields
| Field Name | Description |
|---|---|
maxLength - Int
|
The maximum amount of characters that can be entered into the form field when it is a text type. |
picklistPrefix - String!
|
The text to display before a user has made a selection when it is a picklist type. |
entityId - Int!
|
The entity ID of the form field. |
label - String!
|
The label to display for the form field. |
sortOrder - Int!
|
The sort order priority of the form field. |
isBuiltIn - Boolean!
|
Indicates whether the form field is built-in. |
isRequired - Boolean!
|
Indicates whether the form field is required. |
Example
{
"maxLength": 987,
"picklistPrefix": "xyz789",
"entityId": 987,
"label": "xyz789",
"sortOrder": 123,
"isBuiltIn": false,
"isRequired": false
}
PopularBrandConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [PopularBrandEdge!]
|
A list of edges. |
Example
{
"pageInfo": PageInfo,
"edges": [PopularBrandEdge]
}
PopularBrandEdge
Description
An edge in a connection.
Fields
| Field Name | Description |
|---|---|
node - PopularBrandType!
|
The item at the end of the edge. |
cursor - String!
|
A cursor for use in pagination. |
Example
{
"node": PopularBrandType,
"cursor": "abc123"
}
PopularBrandType
PriceRanges
Description
The min and max range of prices that apply to this product.
Fields
| Field Name | Description |
|---|---|
priceRange - MoneyRange!
|
Product price min/max range. |
retailPriceRange - MoneyRange
|
Product retail price min/max range. |
Example
{
"priceRange": MoneyRange,
"retailPriceRange": MoneyRange
}
PriceSearchFilter
Description
Price Filter
Fields
| Field Name | Description |
|---|---|
selected - PriceSearchFilterItem
|
Selected price filters. |
name - String!
|
Display name for the filter. |
isCollapsedByDefault - Boolean!
|
Indicates whether filter is collapsed by default. |
Example
{
"selected": PriceSearchFilterItem,
"name": "abc123",
"isCollapsedByDefault": false
}
PriceSearchFilterInput
PriceSearchFilterItem
Prices
Description
The various prices that can be set on a product.
Fields
| Field Name | Description |
|---|---|
price - Money!
|
Calculated price of the product. Calculated price takes into account basePrice, salePrice, rules (modifier, option, option set) that apply to the product configuration, and customer group discounts. It represents the in-cart price for a product configuration without bulk pricing rules. |
salePrice - Money
|
Sale price of the product. |
basePrice - Money
|
Original price of the product. |
retailPrice - Money
|
Retail price of the product. |
mapPrice - Money
|
Minimum advertised price of the product. |
priceRange - MoneyRange!
|
Product price min/max range. |
retailPriceRange - MoneyRange
|
Product retail price min/max range. |
saved - Money
|
The difference between the retail price (MSRP) and the current price, which can be presented to the shopper as their savings. |
bulkPricing - [BulkPricingTier!]!
|
List of bulk pricing tiers applicable to a product or variant. |
Example
{
"price": Money,
"salePrice": Money,
"basePrice": Money,
"retailPrice": Money,
"mapPrice": Money,
"priceRange": MoneyRange,
"retailPriceRange": MoneyRange,
"saved": Money,
"bulkPricing": [BulkPricingTier]
}
Product
Description
Product
Fields
| Field Name | Description |
|---|---|
id - ID!
|
The ID of an object |
entityId - Int!
|
Id of the product. |
sku - String!
|
Default product variant when no options are selected. |
path - String!
|
Relative URL path to product page. |
name - String!
|
Name of the product. |
description - String!
|
Description of the product. |
plainTextDescription - String!
|
Description of the product in plain text. |
Arguments
|
|
warranty - String!
|
Warranty information of the product. |
minPurchaseQuantity - Int
|
Minimum purchasable quantity for this product in a single order. |
maxPurchaseQuantity - Int
|
Maximum purchasable quantity for this product in a single order. |
addToCartUrl - String!
|
Absolute URL path for adding a product to cart. |
addToWishlistUrl - String!
|
Absolute URL path for adding a product to customer's wishlist. Deprecated. |
prices - Prices
|
Prices object determined by supplied product ID, variant ID, and selected option IDs. |
Arguments
|
|
priceRanges - PriceRanges
|
The minimum and maximum price of this product based on variant pricing and/or modifier price rules. Use priceRanges inside prices node instead. |
Arguments
|
|
weight - Measurement
|
Weight of the product. |
height - Measurement
|
Height of the product. |
width - Measurement
|
Width of the product. |
depth - Measurement
|
Depth of the product. |
options - OptionConnection!
|
Product options. Use productOptions instead. |
productOptions - ProductOptionConnection!
|
Product options. |
reviewSummary - Reviews!
|
Summary of the product reviews, includes the total number of reviews submitted and summation of the ratings on the reviews (ratings range from 0-5 per review). |
type - String!
|
Type of product, ex: physical, digital |
availability - String!
|
The availability state of the product. Use status inside availabilityV2 instead. |
availabilityDescription - String!
|
A few words telling the customer how long it will normally take to ship this product, such as 'Usually ships in 24 hours'. Use description inside availabilityV2 instead. |
availabilityV2 - ProductAvailability!
|
The availability state of the product. |
categories - CategoryConnection!
|
List of categories associated with the product. |
brand - Brand
|
Brand associated with the product. |
variants - VariantConnection!
|
Variants associated with the product. |
customFields - CustomFieldConnection!
|
Custom fields of the product. |
images - ImageConnection!
|
A list of the images for a product. |
defaultImage - Image
|
Default image for a product. |
relatedProducts - RelatedProductsConnection!
|
Related products for this product. |
Arguments
|
|
inventory - ProductInventory!
|
Inventory information of the product. |
metafields - MetafieldConnection!
|
Metafield data related to a product. |
upc - String
|
Universal product code. |
mpn - String
|
Manufacturer part number. |
gtin - String
|
Global trade item number. |
createdAt - DateTimeExtended!
|
Product creation date Alpha version. Do not use in production. |
reviews - ReviewConnection!
|
Reviews associated with the product. |
Arguments
|
|
seo - SeoDetails!
|
Product SEO details. |
giftWrappingOptions - GiftWrappingConnection!
|
Gift wrapping options available for the product. |
condition - ProductConditionType
|
Product condition |
showCartAction - Boolean!
|
Whether or not the cart call to action should be visible for this product. |
Example
{
"id": "4",
"entityId": 987,
"sku": "abc123",
"path": "abc123",
"name": "abc123",
"description": "xyz789",
"plainTextDescription": "xyz789",
"warranty": "xyz789",
"minPurchaseQuantity": 987,
"maxPurchaseQuantity": 987,
"addToCartUrl": "xyz789",
"addToWishlistUrl": "xyz789",
"prices": Prices,
"priceRanges": PriceRanges,
"weight": Measurement,
"height": Measurement,
"width": Measurement,
"depth": Measurement,
"options": OptionConnection,
"productOptions": ProductOptionConnection,
"reviewSummary": Reviews,
"type": "abc123",
"availability": "xyz789",
"availabilityDescription": "abc123",
"availabilityV2": ProductAvailability,
"categories": CategoryConnection,
"brand": Brand,
"variants": VariantConnection,
"customFields": CustomFieldConnection,
"images": ImageConnection,
"defaultImage": Image,
"relatedProducts": RelatedProductsConnection,
"inventory": ProductInventory,
"metafields": MetafieldConnection,
"upc": "abc123",
"mpn": "xyz789",
"gtin": "xyz789",
"createdAt": DateTimeExtended,
"reviews": ReviewConnection,
"seo": SeoDetails,
"giftWrappingOptions": GiftWrappingConnection,
"condition": "NEW",
"showCartAction": true
}
ProductAttributeSearchFilter
Description
Product Attribute Filter
Fields
| Field Name | Description |
|---|---|
displayProductCount - Boolean!
|
Indicates whether to display product count next to the filter. |
filterName - String!
|
Filter name for building filter URLs |
attributes - ProductAttributeSearchFilterItemConnection!
|
List of available product attributes. |
name - String!
|
Display name for the filter. |
isCollapsedByDefault - Boolean!
|
Indicates whether filter is collapsed by default. |
Example
{
"displayProductCount": true,
"filterName": "xyz789",
"attributes": ProductAttributeSearchFilterItemConnection,
"name": "abc123",
"isCollapsedByDefault": true
}
ProductAttributeSearchFilterInput
Description
Filter by the attributes of products such as Product Options and Product Custom Fields. This filter will do nothing unless your store has the Product Filtering feature available on your plan and enabled. If it is supplied when your store does not have the feature enabled, it will be silently ignored.
Fields
| Input Field | Description |
|---|---|
attribute - String!
|
Product attributes |
values - [String!]!
|
Product attribute values |
Example
{
"attribute": "xyz789",
"values": ["xyz789"]
}
ProductAttributeSearchFilterItem
Description
Specific product attribute filter item
Example
{
"value": "abc123",
"isSelected": true,
"productCount": 123
}
ProductAttributeSearchFilterItemConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [ProductAttributeSearchFilterItemEdge!]
|
A list of edges. |
Example
{
"pageInfo": PageInfo,
"edges": [ProductAttributeSearchFilterItemEdge]
}
ProductAttributeSearchFilterItemEdge
Description
An edge in a connection.
Fields
| Field Name | Description |
|---|---|
node - ProductAttributeSearchFilterItem!
|
The item at the end of the edge. |
cursor - String!
|
A cursor for use in pagination. |
Example
{
"node": ProductAttributeSearchFilterItem,
"cursor": "abc123"
}
ProductAvailability
Description
Product availability
Fields
| Field Name | Description |
|---|---|
status - ProductAvailabilityStatus!
|
The availability state of the product. |
description - String!
|
A few words telling the customer how long it will normally take to ship this product, such as 'Usually ships in 24 hours'. |
Possible Types
| ProductAvailability Types |
|---|
Example
{
"status": "Available",
"description": "abc123"
}
ProductAvailabilityStatus
Description
Product availability status
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
Example
"Available"
ProductAvailable
Description
Available Product
Fields
| Field Name | Description |
|---|---|
status - ProductAvailabilityStatus!
|
The availability state of the product. |
description - String!
|
A few words telling the customer how long it will normally take to ship this product, such as 'Usually ships in 24 hours'. |
Example
{
"status": "Available",
"description": "xyz789"
}
ProductConditionType
Description
Product condition
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
Example
"NEW"
ProductConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [ProductEdge!]
|
A list of edges. |
collectionInfo - CollectionInfo
|
Collection info |
Example
{
"pageInfo": PageInfo,
"edges": [ProductEdge],
"collectionInfo": CollectionInfo
}
ProductEdge
ProductInventory
Description
Product Inventory Information
Fields
| Field Name | Description |
|---|---|
isInStock - Boolean!
|
Indicates whether this product is in stock. |
hasVariantInventory - Boolean!
|
Indicates whether this product's inventory is being tracked on variant level. If true, you may wish to check the variants node to understand the true inventory of each individual variant, rather than relying on this product-level aggregate to understand how many items may be added to cart. |
aggregated - AggregatedInventory
|
Aggregated product inventory information. This data may not be available if not set or if the store's Inventory Settings have disabled displaying stock levels on the storefront. |
Example
{
"isInStock": false,
"hasVariantInventory": false,
"aggregated": AggregatedInventory
}
ProductOption
Description
Product Option
Fields
| Field Name | Description |
|---|---|
entityId - Int!
|
Unique ID for the option. |
displayName - String!
|
Display name for the option. |
isRequired - Boolean!
|
One of the option values is required to be selected for the checkout. |
values - OptionValueConnection!
|
Option values. |
Example
{
"entityId": 987,
"displayName": "xyz789",
"isRequired": false,
"values": OptionValueConnection
}
ProductOptionConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [ProductOptionEdge!]
|
A list of edges. |
Example
{
"pageInfo": PageInfo,
"edges": [ProductOptionEdge]
}
ProductOptionEdge
Description
An edge in a connection.
Fields
| Field Name | Description |
|---|---|
node - CatalogProductOption!
|
The item at the end of the edge. |
cursor - String!
|
A cursor for use in pagination. |
Example
{
"node": CatalogProductOption,
"cursor": "xyz789"
}
ProductOptionValue
ProductOptionValueConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [ProductOptionValueEdge!]
|
A list of edges. |
Example
{
"pageInfo": PageInfo,
"edges": [ProductOptionValueEdge]
}
ProductOptionValueEdge
Description
An edge in a connection.
Fields
| Field Name | Description |
|---|---|
node - CatalogProductOptionValue!
|
The item at the end of the edge. |
cursor - String!
|
A cursor for use in pagination. |
Example
{
"node": CatalogProductOptionValue,
"cursor": "xyz789"
}
ProductOutOfStockBehavior
Description
Behavior of the product when stock is equal to 0
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
Example
"DO_NOTHING"
ProductPickListOptionValue
Description
A Product PickList Value - a product to be mapped to the base product if selected.
Fields
| Field Name | Description |
|---|---|
productId - Int!
|
The ID of the product associated with this option value. |
defaultImage - Image
|
Default image for a pick list product. |
entityId - Int!
|
Unique ID for the option value. |
label - String!
|
Label for the option value. |
isDefault - Boolean!
|
Indicates whether this value is the chosen default selected value. |
isSelected - Boolean
|
Indicates whether this value is selected based on sku/variantEntityId/optionValueIds overlay requested on the product node level. |
Example
{
"productId": 987,
"defaultImage": Image,
"entityId": 987,
"label": "abc123",
"isDefault": true,
"isSelected": true
}
ProductPreOrder
Description
PreOrder Product
Fields
| Field Name | Description |
|---|---|
message - String
|
The message to be shown in the store when a product is put into the pre-order availability state, e.g. "Expected release date is %%DATE%%" |
willBeReleasedAt - DateTimeExtended
|
Product release date |
status - ProductAvailabilityStatus!
|
The availability state of the product. |
description - String!
|
A few words telling the customer how long it will normally take to ship this product, such as 'Usually ships in 24 hours'. |
Example
{
"message": "xyz789",
"willBeReleasedAt": DateTimeExtended,
"status": "Available",
"description": "abc123"
}
ProductRedirect
ProductReviewsFiltersInput
Description
Product reviews filters.
Fields
| Input Field | Description |
|---|---|
rating - ProductReviewsRatingFilterInput
|
Product reviews filter by rating. |
Example
{"rating": ProductReviewsRatingFilterInput}
ProductReviewsRatingFilterInput
ProductReviewsSortInput
Description
Product reviews sorting.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
Example
"HIGHEST_RATING"
PublicWishlist
Description
Public Wishlist
Fields
| Field Name | Description |
|---|---|
entityId - Int!
|
The wishlist id. |
name - String!
|
The wishlist name. |
token - String!
|
The wishlist token. |
items - WishlistItemConnection!
|
A list of the wishlist items |
Arguments
|
|
Example
{
"entityId": 987,
"name": "xyz789",
"token": "xyz789",
"items": WishlistItemConnection
}
RadioButtonsFormField
Description
Radio buttons form field.
Fields
| Field Name | Description |
|---|---|
options - [FormFieldOption!]!
|
The options for the form field. |
entityId - Int!
|
The entity ID of the form field. |
label - String!
|
The label to display for the form field. |
sortOrder - Int!
|
The sort order priority of the form field. |
isBuiltIn - Boolean!
|
Indicates whether the form field is built-in. |
isRequired - Boolean!
|
Indicates whether the form field is required. |
Example
{
"options": [FormFieldOption],
"entityId": 123,
"label": "abc123",
"sortOrder": 987,
"isBuiltIn": true,
"isRequired": false
}
RatingSearchFilter
Description
Rating Filter
Example
{
"ratings": RatingSearchFilterItemConnection,
"name": "xyz789",
"isCollapsedByDefault": true
}
RatingSearchFilterInput
Description
Filter by rating. At least a minRating or maxRating must be supplied. This filter will do nothing unless your store has the Product Filtering feature available on your plan and enabled. If it is supplied when your store does not have the feature enabled, it will be silently ignored.
Example
{"minRating": 123.45, "maxRating": 123.45}
RatingSearchFilterItem
Description
Specific rating filter item
Example
{
"value": "abc123",
"isSelected": true,
"productCount": 123
}
RatingSearchFilterItemConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [RatingSearchFilterItemEdge!]
|
A list of edges. |
Example
{
"pageInfo": PageInfo,
"edges": [RatingSearchFilterItemEdge]
}
RatingSearchFilterItemEdge
Description
An edge in a connection.
Fields
| Field Name | Description |
|---|---|
node - RatingSearchFilterItem!
|
The item at the end of the edge. |
cursor - String!
|
A cursor for use in pagination. |
Example
{
"node": RatingSearchFilterItem,
"cursor": "abc123"
}
RawHtmlPage
Description
A raw HTML page.
Fields
| Field Name | Description |
|---|---|
id - ID!
|
The ID of an object |
path - String!
|
The URL path of the page. |
htmlBody - String!
|
The body of the page. |
plainTextSummary - String!
|
The plain text summary of the page body. |
Arguments
|
|
entityId - Int!
|
Unique ID for the web page. |
parentEntityId - Int
|
Unique ID for the parent page. |
name - String!
|
Page name. |
isVisibleInNavigation - Boolean!
|
Whether or not the page should be visible in the navigation menu. |
seo - SeoDetails!
|
Page SEO details. |
Example
{
"id": 4,
"path": "xyz789",
"htmlBody": "xyz789",
"plainTextSummary": "xyz789",
"entityId": 123,
"parentEntityId": 987,
"name": "abc123",
"isVisibleInNavigation": false,
"seo": SeoDetails
}
ReCaptchaSettings
ReCaptchaV2Input
Description
Recaptcha input (in case Recaptcha is enabled on a store)
Fields
| Input Field | Description |
|---|---|
token - String!
|
Recaptcha token |
Example
{"token": "xyz789"}
Redirect
Description
Redirect.
Fields
| Field Name | Description |
|---|---|
id - ID!
|
The ID of an object. |
fromPath - String!
|
Redirected url. |
to - RedirectTo!
|
Additional information about redirect. |
toUrl - String!
|
Full destination url. |
Example
{
"id": 4,
"fromPath": "abc123",
"to": ManualRedirect,
"toUrl": "xyz789"
}
RedirectTo
Description
Type of the redirect.
Types
| Union Types |
|---|
Example
ManualRedirect
Region
RegisterCustomerError
Description
An error when registering a customer.
Example
EmailAlreadyInUseError
RegisterCustomerInput
Description
The values to use for customer registration.
Fields
| Input Field | Description |
|---|---|
firstName - String!
|
The first name of the customer. |
lastName - String!
|
The last name of the customer. |
email - String!
|
The email of the customer. |
password - String!
|
The password supplied by the customer. |
phone - String
|
The phone number of the customer. |
company - String
|
The company of the customer. |
address - AddCustomerAddressInput
|
The address of the customer. |
formFields - CustomerFormFieldsInput
|
The custom form fields that the customer filled out. |
Example
{
"firstName": "abc123",
"lastName": "abc123",
"email": "xyz789",
"password": "abc123",
"phone": "abc123",
"company": "xyz789",
"address": AddCustomerAddressInput,
"formFields": CustomerFormFieldsInput
}
RegisterCustomerResult
Description
The result of registering a customer.
Fields
| Field Name | Description |
|---|---|
customer - Customer
|
The customer that was registered. |
errors - [RegisterCustomerError!]!
|
The errors, if any, that occured during the registration. |
Example
{
"customer": Customer,
"errors": [EmailAlreadyInUseError]
}
RelatedProductsConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [RelatedProductsEdge!]
|
A list of edges. |
Example
{
"pageInfo": PageInfo,
"edges": [RelatedProductsEdge]
}
RelatedProductsEdge
RenderedRegionsByPageType
Description
The rendered regions by specific page.
Fields
| Field Name | Description |
|---|---|
regions - [Region!]!
|
List of regions |
Example
{"regions": [Region]}
RequestResetPasswordError
Description
An error when requesting a reset password email.
Types
| Union Types |
|---|
Example
ValidationError
RequestResetPasswordInput
RequestResetPasswordResult
Description
The result of requesting a reset password email.
Fields
| Field Name | Description |
|---|---|
errors - [RequestResetPasswordError!]!
|
The errors, if any, that occured during the request. |
Example
{"errors": [ValidationError]}
ResetPasswordError
Description
An error when resetting a password.
Types
| Union Types |
|---|
Example
ValidationError
ResetPasswordInput
Description
Input for resetting a password.
Example
{
"customerEntityId": 987,
"token": "abc123",
"newPassword": "abc123"
}
ResetPasswordResult
Description
The result of resetting a password.
Fields
| Field Name | Description |
|---|---|
errors - [ResetPasswordError!]!
|
The errors, if any, that occurred during the request. |
Example
{"errors": [ValidationError]}
Review
Description
Review
Example
{
"entityId": {},
"author": Author,
"title": "abc123",
"text": "abc123",
"rating": 123,
"createdAt": DateTimeExtended
}
ReviewConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [ReviewEdge!]
|
A list of edges. |
Example
{
"pageInfo": PageInfo,
"edges": [ReviewEdge]
}
ReviewEdge
Reviews
Description
Review Rating Summary
Example
{"averageRating": 123.45, "numberOfReviews": 987, "summationOfRatings": 987}
Route
RouteRedirectBehavior
Description
Enum value to specify the desired behavior when encountering a redirect for the requested route.
Values
| Enum Value | Description |
|---|---|
|
|
If there is a dynamic/association redirect configured, the node node will return a resulting entity (category, product, etc.) that a redirect points to. If there is a static/manual redirect configured, the node node will return null, as there is no entity associated with it, the redirect node however will return the redirect details. |
|
|
No redirects are taken into account, relying on custom URLs only. If there is the same path for both redirect and entity URL configured, both redirect node and node node return respective non-null values. |
Example
"FOLLOW"
Search
Description
Store search settings.
Fields
| Field Name | Description |
|---|---|
productFilteringEnabled - Boolean!
|
Product filtering enabled. |
Example
{"productFilteringEnabled": false}
SearchProductFilter
SearchProductFilterConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [SearchProductFilterEdge!]
|
A list of edges. |
Example
{
"pageInfo": PageInfo,
"edges": [SearchProductFilterEdge]
}
SearchProductFilterEdge
Description
An edge in a connection.
Fields
| Field Name | Description |
|---|---|
node - SearchProductFilter!
|
The item at the end of the edge. |
cursor - String!
|
A cursor for use in pagination. |
Example
{
"node": SearchProductFilter,
"cursor": "abc123"
}
SearchProducts
Description
Container for catalog search results, which may contain both products as well as a list of search filters for further refinement.
Fields
| Field Name | Description |
|---|---|
products - ProductConnection!
|
Details of the products. |
filters - SearchProductFilterConnection!
|
Available product filters. |
Example
{
"products": ProductConnection,
"filters": SearchProductFilterConnection
}
SearchProductsFiltersInput
Description
Object containing available search filters for use when querying Products.
Fields
| Input Field | Description |
|---|---|
searchTerm - String
|
Textual search term. Used to search for products based on text entered by a shopper, typically in a search box. Searches against several fields on the product including Name, SKU, and Description. |
price - PriceSearchFilterInput
|
Search by price range. At least a minPrice or maxPrice must be supplied. |
rating - RatingSearchFilterInput
|
Filter by rating. At least a minRating or maxRating must be supplied. This filter will do nothing unless your store has the Product Filtering feature available on your plan and enabled. If it is supplied when your store does not have the feature enabled, it will be silently ignored. |
categoryEntityId - Int
|
Filter by products belonging to a single Category. This is intended for use when presenting a Category page in a PLP experience. This argument must be used in order for custom product sorts and custom product filtering settings targeted at a particular category to take effect. |
categoryEntityIds - [Int!]
|
Filter by products belonging to any of the specified Categories. Intended for Advanced Search and Faceted Search/Product Filtering use cases, not for a page for a specific Category. |
searchSubCategories - Boolean
|
Boolean argument to determine whether products within sub-Categories will be returned when filtering products by Category. Defaults to False if not supplied. |
brandEntityIds - [Int!]
|
Filter by products belonging to any of the specified Brands. |
productAttributes - [ProductAttributeSearchFilterInput!]
|
Filter by the attributes of products such as Product Options and Product Custom Fields. This filter will do nothing unless your store has the Product Filtering feature available on your plan and enabled. If it is supplied when your store does not have the feature enabled, it will be silently ignored. |
isFreeShipping - Boolean
|
Filters by Products which have explicit Free Shipping configured within the catalog. If not supplied, the Free Shipping status of products will not be considered when returning the list of products. |
isFeatured - Boolean
|
Filters by Products which have explicitly been marked as Featured within the catalog. If not supplied, the Featured status of products will not be considered when returning the list of products. |
hideOutOfStock - Boolean
|
When set to True, hides products which are out of stock. Defaults to False. This filter will do nothing unless your store has the Product Filtering feature available on your plan and enabled. If it is supplied when your store does not have the feature enabled, it will be silently ignored. |
Example
{
"searchTerm": "xyz789",
"price": PriceSearchFilterInput,
"rating": RatingSearchFilterInput,
"categoryEntityId": 987,
"categoryEntityIds": [987],
"searchSubCategories": false,
"brandEntityIds": [123],
"productAttributes": [
ProductAttributeSearchFilterInput
],
"isFreeShipping": false,
"isFeatured": true,
"hideOutOfStock": false
}
SearchProductsSortInput
Description
Sort to use for the product results. Relevance is the default for textual search terms, and “Featured” is the default for category page contexts without a search term.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"A_TO_Z"
SearchQueries
Description
The Search queries.
Fields
| Field Name | Description |
|---|---|
searchProducts - SearchProducts!
|
Details of the products and facets matching given search criteria. |
Arguments
|
|
Example
{"searchProducts": SearchProducts}
SelectCheckoutShippingOptionDataInput
Description
Select checkout shipping option input data object
Fields
| Input Field | Description |
|---|---|
shippingOptionEntityId - String!
|
The shipping option id |
Example
{"shippingOptionEntityId": "abc123"}
SelectCheckoutShippingOptionInput
Description
Select checkout shipping option input object
Fields
| Input Field | Description |
|---|---|
checkoutEntityId - String!
|
The checkout id |
consignmentEntityId - String!
|
The consignment id |
data - SelectCheckoutShippingOptionDataInput!
|
Select checkout shipping option data object |
Example
{
"checkoutEntityId": "xyz789",
"consignmentEntityId": "abc123",
"data": SelectCheckoutShippingOptionDataInput
}
SelectCheckoutShippingOptionResult
Description
Select checkout shipping option result
Fields
| Field Name | Description |
|---|---|
checkout - Checkout
|
The Checkout that is updated as a result of mutation. |
Example
{"checkout": Checkout}
SeoDetails
Settings
Description
Store settings information from the control panel.
Fields
| Field Name | Description |
|---|---|
storeName - String!
|
The name of the store. |
storeHash - String!
|
The hash of the store. |
status - StorefrontStatusType!
|
The current store status. |
logo - LogoField!
|
Logo information for the store. Use logoV2 instead.
|
logoV2 - StoreLogo!
|
Logo information for the store. |
contact - ContactField
|
Contact information for the store. |
url - UrlField!
|
Store urls. |
display - DisplayField!
|
Store display format information. |
channelId - Long!
|
Channel ID. |
tax - TaxDisplaySettings
|
The tax display settings object |
search - Search!
|
Store search settings. |
storefront - Storefront!
|
Storefront settings. |
inventory - InventorySettings
|
Inventory settings. |
reCaptcha - ReCaptchaSettings!
|
ReCaptcha settings. |
socialMediaLinks - [SocialMediaLink!]!
|
The social media links of connected platforms to the storefront. |
checkout - CheckoutSettings
|
Checkout settings. |
statusMessage - String
|
The customer-facing message associated with the current store status. |
formFields - FormFields!
|
The form fields to display on the storefront during customer registration or address creation. |
Example
{
"storeName": "abc123",
"storeHash": "xyz789",
"status": "HIBERNATION",
"logo": LogoField,
"logoV2": StoreTextLogo,
"contact": ContactField,
"url": UrlField,
"display": DisplayField,
"channelId": {},
"tax": TaxDisplaySettings,
"search": Search,
"storefront": Storefront,
"inventory": InventorySettings,
"reCaptcha": ReCaptchaSettings,
"socialMediaLinks": [SocialMediaLink],
"checkout": CheckoutSettings,
"statusMessage": "xyz789",
"formFields": FormFields
}
ShopByPriceConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [ShopByPriceEdge!]
|
A list of edges. |
Example
{
"pageInfo": PageInfo,
"edges": [ShopByPriceEdge]
}
ShopByPriceEdge
Description
An edge in a connection.
Fields
| Field Name | Description |
|---|---|
node - ShopByPriceRange!
|
The item at the end of the edge. |
cursor - String!
|
A cursor for use in pagination. |
Example
{
"node": ShopByPriceRange,
"cursor": "abc123"
}
ShopByPriceRange
Description
Category shop by price money ranges
Fields
| Field Name | Description |
|---|---|
ranges - MoneyRange!
|
Category shop by price range. |
Example
{"ranges": MoneyRange}
Site
Description
A site
Fields
| Field Name | Description |
|---|---|
search - SearchQueries!
|
The Search queries. |
categoryTree - [CategoryTreeItem!]!
|
A tree of categories. |
Arguments
|
|
category - Category
|
Retrieve a category object by the id. |
Arguments
|
|
brands - BrandConnection!
|
Details of the brand. |
products - ProductConnection!
|
Details of the products. |
Arguments
|
|
newestProducts - ProductConnection!
|
Details of the newest products. |
Arguments
|
|
bestSellingProducts - ProductConnection!
|
Details of the best selling products. |
Arguments
|
|
featuredProducts - ProductConnection!
|
Details of the featured products. |
Arguments
|
|
product - Product
|
A single product object with variant pricing overlay capabilities. |
Arguments
|
|
route - Route!
|
Route for a node |
Arguments
|
|
settings - Settings
|
Store settings. |
content - Content!
|
The page content. |
currency - Currency
|
Currency details. |
Arguments
|
|
currencies - CurrencyConnection!
|
Store Currencies. |
publicWishlist - PublicWishlist
|
Public Wishlist |
Arguments
|
|
popularBrands - PopularBrandConnection!
|
List of brands sorted by product count. |
cart - Cart
|
The Cart of the current customer. |
Arguments
|
|
checkout - Checkout
|
The checkout of the current customer. |
Arguments
|
|
brand - Brand
|
Details of a brand. |
Arguments
|
|
Example
{
"search": SearchQueries,
"categoryTree": [CategoryTreeItem],
"category": Category,
"brands": BrandConnection,
"products": ProductConnection,
"newestProducts": ProductConnection,
"bestSellingProducts": ProductConnection,
"featuredProducts": ProductConnection,
"product": Product,
"route": Route,
"settings": Settings,
"content": Content,
"currency": Currency,
"currencies": CurrencyConnection,
"publicWishlist": PublicWishlist,
"popularBrands": PopularBrandConnection,
"cart": Cart,
"checkout": Checkout,
"brand": Brand
}
SocialMediaLink
SpecialHour
StockLevelDisplay
Description
Stock level display setting
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
Example
"DONT_SHOW"
StoreImageLogo
Description
Store logo as image.
Fields
| Field Name | Description |
|---|---|
image - Image!
|
Logo image. |
Example
{"image": Image}
StoreLogo
Description
Store logo.
Types
| Union Types |
|---|
Example
StoreTextLogo
StoreTextLogo
Description
Store logo as text.
Fields
| Field Name | Description |
|---|---|
text - String!
|
Logo text. |
Example
{"text": "xyz789"}
Storefront
Description
Storefront settings.
Fields
| Field Name | Description |
|---|---|
catalog - Catalog
|
Storefront catalog settings. |
Example
{"catalog": Catalog}
StorefrontStatusType
Description
Storefront Mode
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
Example
"HIBERNATION"
String
Description
The String scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
Example
"abc123"
SubCategorySearchFilterItem
Description
Specific sub-category filter item
Fields
| Field Name | Description |
|---|---|
entityId - Int!
|
Category ID. |
name - String!
|
Category name. |
isSelected - Boolean!
|
Indicates whether category is selected. |
productCount - Int!
|
Indicates how many products available for this filter. |
subCategories - SubCategorySearchFilterItemConnection!
|
List of available sub-categories. |
Example
{
"entityId": 123,
"name": "xyz789",
"isSelected": false,
"productCount": 123,
"subCategories": SubCategorySearchFilterItemConnection
}
SubCategorySearchFilterItemConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [SubCategorySearchFilterItemEdge!]
|
A list of edges. |
Example
{
"pageInfo": PageInfo,
"edges": [SubCategorySearchFilterItemEdge]
}
SubCategorySearchFilterItemEdge
Description
An edge in a connection.
Fields
| Field Name | Description |
|---|---|
node - SubCategorySearchFilterItem!
|
The item at the end of the edge. |
cursor - String!
|
A cursor for use in pagination. |
Example
{
"node": SubCategorySearchFilterItem,
"cursor": "xyz789"
}
SubmitContactUsDataInput
Description
Input for contact us form
Example
{
"fullName": "xyz789",
"phoneNumber": "abc123",
"email": "xyz789",
"orderNumber": "abc123",
"companyName": "xyz789",
"rmaNumber": "abc123",
"comments": "abc123"
}
SubmitContactUsError
Description
Error that occurred when submitting the contact us email
Types
| Union Types |
|---|
Example
ValidationError
SubmitContactUsInput
Description
Input for contact us form
Fields
| Input Field | Description |
|---|---|
pageEntityId - Int!
|
The contact page we're sending on behalf of |
data - SubmitContactUsDataInput!
|
The form data we are submitting |
Example
{"pageEntityId": 987, "data": SubmitContactUsDataInput}
SubmitContactUsResult
Description
Result of submitting contact us form
Fields
| Field Name | Description |
|---|---|
errors - [SubmitContactUsError!]!
|
List of errors that occurred executing the mutation. |
Example
{"errors": [ValidationError]}
SwatchOptionValue
Description
A swatch option value - swatch values can be associated with a list of hexidecimal colors or an image.
Fields
| Field Name | Description |
|---|---|
hexColors - [String!]!
|
List of up to 3 hex encoded colors to associate with a swatch value. |
imageUrl - String
|
Absolute path of a swatch texture image. |
entityId - Int!
|
Unique ID for the option value. |
label - String!
|
Label for the option value. |
isDefault - Boolean!
|
Indicates whether this value is the chosen default selected value. |
isSelected - Boolean
|
Indicates whether this value is selected based on sku/variantEntityId/optionValueIds overlay requested on the product node level. |
Example
{
"hexColors": ["xyz789"],
"imageUrl": "xyz789",
"entityId": 987,
"label": "xyz789",
"isDefault": true,
"isSelected": true
}
TaxDisplaySettings
Description
The tax display settings object
Fields
| Field Name | Description |
|---|---|
pdp - TaxPriceDisplay!
|
Tax display setting for Product Details Page. |
plp - TaxPriceDisplay!
|
Tax display setting for Product List Page. |
Example
{"pdp": "BOTH", "plp": "BOTH"}
TaxPriceDisplay
Description
Tax setting can be set included or excluded (Tax setting can also be set to both on PDP/PLP).
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
Example
"BOTH"
TextFieldOption
Description
A single line text input field.
Fields
| Field Name | Description |
|---|---|
defaultValue - String
|
Default value of the text field option. |
minLength - Int
|
The minimum number of characters. |
maxLength - Int
|
The maximum number of characters. |
entityId - Int!
|
Unique ID for the option. |
displayName - String!
|
Display name for the option. |
isRequired - Boolean!
|
One of the option values is required to be selected for the checkout. |
isVariantOption - Boolean!
|
Indicates whether it is a variant option or modifier. |
Example
{
"defaultValue": "abc123",
"minLength": 123,
"maxLength": 987,
"entityId": 123,
"displayName": "abc123",
"isRequired": false,
"isVariantOption": true
}
TextFormField
Description
A single line text form field.
Fields
| Field Name | Description |
|---|---|
defaultText - String
|
The default text value of the text form field. |
maxLength - Int
|
The maximum amount of characters that can be entered into the form field. |
entityId - Int!
|
The entity ID of the form field. |
label - String!
|
The label to display for the form field. |
sortOrder - Int!
|
The sort order priority of the form field. |
isBuiltIn - Boolean!
|
Indicates whether the form field is built-in. |
isRequired - Boolean!
|
Indicates whether the form field is required. |
Example
{
"defaultText": "xyz789",
"maxLength": 987,
"entityId": 123,
"label": "abc123",
"sortOrder": 123,
"isBuiltIn": true,
"isRequired": false
}
TextFormFieldInput
TextFormFieldValue
Description
Text (includes basic text field and multi-line text) custom form field value.
Example
{
"text": "abc123",
"entityId": 123,
"name": "abc123"
}
UnapplyCheckoutCouponDataInput
Description
Unapply checkout coupon data object
Fields
| Input Field | Description |
|---|---|
couponCode - String!
|
The checkout coupon code |
Example
{"couponCode": "xyz789"}
UnapplyCheckoutCouponInput
Description
Unapply checkout coupon input object
Fields
| Input Field | Description |
|---|---|
checkoutEntityId - String!
|
The checkout id |
data - UnapplyCheckoutCouponDataInput!
|
Unapply checkout coupon data object |
Example
{
"checkoutEntityId": "abc123",
"data": UnapplyCheckoutCouponDataInput
}
UnapplyCheckoutCouponResult
Description
Unapply checkout coupon result
Fields
| Field Name | Description |
|---|---|
checkout - Checkout
|
The Checkout that is updated as a result of mutation. |
Example
{"checkout": Checkout}
UnassignCartFromCustomerInput
Description
Unassign cart from the customer input object.
Fields
| Input Field | Description |
|---|---|
cartEntityId - String!
|
The cart id. |
Example
{"cartEntityId": "abc123"}
UnassignCartFromCustomerResult
Description
Unassign cart from the customer result.
Fields
| Field Name | Description |
|---|---|
cart - Cart
|
The Cart that is updated as a result of mutation. |
Example
{"cart": Cart}
UpdateCartCurrencyDataInput
Description
Update cart currency data object
Fields
| Input Field | Description |
|---|---|
currencyCode - String!
|
ISO-4217 currency code |
Example
{"currencyCode": "xyz789"}
UpdateCartCurrencyInput
Description
Update cart currency input object
Fields
| Input Field | Description |
|---|---|
cartEntityId - String!
|
The cart id |
data - UpdateCartCurrencyDataInput!
|
Update cart currency data object |
Example
{
"cartEntityId": "xyz789",
"data": UpdateCartCurrencyDataInput
}
UpdateCartCurrencyResult
Description
Update cart currency result
Fields
| Field Name | Description |
|---|---|
cart - Cart
|
The Cart that is updated as a result of mutation. |
Example
{"cart": Cart}
UpdateCartLineItemDataInput
Description
Update cart line item data object
Fields
| Input Field | Description |
|---|---|
lineItem - CartLineItemInput
|
The cart line item |
giftCertificate - CartGiftCertificateInput
|
The gift certificate |
Example
{
"lineItem": CartLineItemInput,
"giftCertificate": CartGiftCertificateInput
}
UpdateCartLineItemInput
Description
Update cart line item input object
Fields
| Input Field | Description |
|---|---|
cartEntityId - String!
|
The cart id |
lineItemEntityId - String!
|
The line item id |
data - UpdateCartLineItemDataInput!
|
Update cart line item data object |
Example
{
"cartEntityId": "abc123",
"lineItemEntityId": "abc123",
"data": UpdateCartLineItemDataInput
}
UpdateCartLineItemResult
Description
Update cart line item result
Fields
| Field Name | Description |
|---|---|
cart - Cart
|
The Cart that is updated as a result of mutation. |
Example
{"cart": Cart}
UpdateCartMetafieldDataInput
UpdateCartMetafieldError
Description
Error that occured as a result of updateCartMetafield mutation.
Types
| Union Types |
|---|
Example
NotFoundError
UpdateCartMetafieldInput
Description
Input for update cart's metafield mutation.
Fields
| Input Field | Description |
|---|---|
cartEntityId - String!
|
Id of the cart for which to update metafield. |
metafieldEntityId - Int!
|
Id of metafield to update. |
data - UpdateCartMetafieldDataInput!
|
Data to update metafield. |
Example
{
"cartEntityId": "abc123",
"metafieldEntityId": 123,
"data": UpdateCartMetafieldDataInput
}
UpdateCartMetafieldResult
Description
Result of updating metafield for cart.
Fields
| Field Name | Description |
|---|---|
metafield - Metafields
|
Successfully updated metafield for cart. |
errors - [UpdateCartMetafieldError!]!
|
Errors found during update of cart's metafield. |
Example
{
"metafield": Metafields,
"errors": [NotFoundError]
}
UpdateCheckoutBillingAddressDataInput
Description
Update checkout billing address data object
Fields
| Input Field | Description |
|---|---|
address - CheckoutAddressInput!
|
The checkout billing address |
Example
{"address": CheckoutAddressInput}
UpdateCheckoutBillingAddressInput
Description
Update checkout billing address input object
Fields
| Input Field | Description |
|---|---|
checkoutEntityId - String!
|
The checkout id |
addressEntityId - String!
|
The address id |
data - UpdateCheckoutBillingAddressDataInput!
|
Update checkout billing address data object |
Example
{
"checkoutEntityId": "xyz789",
"addressEntityId": "xyz789",
"data": UpdateCheckoutBillingAddressDataInput
}
UpdateCheckoutBillingAddressResult
Description
Update checkout billing address result
Fields
| Field Name | Description |
|---|---|
checkout - Checkout
|
The Checkout that is updated as a result of mutation. |
Example
{"checkout": Checkout}
UpdateCheckoutCustomerMessageDataInput
Description
Update checkout customer message data object
Fields
| Input Field | Description |
|---|---|
message - String!
|
The checkout customer message |
Example
{"message": "xyz789"}
UpdateCheckoutCustomerMessageInput
Description
Update checkout customer message input object
Fields
| Input Field | Description |
|---|---|
checkoutEntityId - String!
|
The checkout id |
data - UpdateCheckoutCustomerMessageDataInput!
|
Update checkout customer message data object |
Example
{
"checkoutEntityId": "abc123",
"data": UpdateCheckoutCustomerMessageDataInput
}
UpdateCheckoutCustomerMessageResult
Description
Update checkout customer message result
Fields
| Field Name | Description |
|---|---|
checkout - Checkout
|
The Checkout that is updated as a result of mutation. |
Example
{"checkout": Checkout}
UpdateCheckoutShippingConsignmentDataInput
Description
Update checkout shipping consignment data object
Fields
| Input Field | Description |
|---|---|
consignment - CheckoutShippingConsignmentInput!
|
Checkout shipping consignment input object |
Example
{"consignment": CheckoutShippingConsignmentInput}
UpdateCheckoutShippingConsignmentInput
Description
Update checkout shipping consignment input object
Fields
| Input Field | Description |
|---|---|
checkoutEntityId - String!
|
The checkout id |
consignmentEntityId - String!
|
The consignment id |
data - UpdateCheckoutShippingConsignmentDataInput!
|
Update checkout shipping consignment data object |
Example
{
"checkoutEntityId": "xyz789",
"consignmentEntityId": "xyz789",
"data": UpdateCheckoutShippingConsignmentDataInput
}
UpdateCheckoutShippingConsignmentResult
Description
Update checkout shipping consignment result
Fields
| Field Name | Description |
|---|---|
checkout - Checkout
|
The Checkout that is updated as a result of mutation. |
Example
{"checkout": Checkout}
UpdateCustomerAddressDataInput
Description
Data fields to update on address.
Fields
| Input Field | Description |
|---|---|
firstName - String
|
First name of address owner. |
lastName - String
|
Last name of the address owner. |
address1 - String
|
First line for the street address. |
address2 - String
|
Second line for the street address. |
city - String
|
City. |
company - String
|
Company name associated with the address. |
countryCode - String
|
2-letter country code. |
stateOrProvince - String
|
Name of State or Province. |
phone - String
|
Phone number. |
postalCode - String
|
Postal code for the address. This is only required for certain countries. |
formFields - CustomerFormFieldsInput
|
Additional form fields defined by merchant. |
Example
{
"firstName": "xyz789",
"lastName": "abc123",
"address1": "abc123",
"address2": "xyz789",
"city": "abc123",
"company": "xyz789",
"countryCode": "xyz789",
"stateOrProvince": "xyz789",
"phone": "xyz789",
"postalCode": "abc123",
"formFields": CustomerFormFieldsInput
}
UpdateCustomerAddressError
Description
Possible response error when attempting to use UpdateCustomerAddress mutation.
Example
CustomerNotLoggedInError
UpdateCustomerAddressInput
Description
Input for updating a customer address.
Fields
| Input Field | Description |
|---|---|
addressEntityId - Int!
|
ID of the address to update. |
data - UpdateCustomerAddressDataInput!
|
Data fields to update on address. |
Example
{
"addressEntityId": 987,
"data": UpdateCustomerAddressDataInput
}
UpdateCustomerAddressResult
Description
Result of UpdateCustomerAddress mutation.
Fields
| Field Name | Description |
|---|---|
address - CustomerAddress
|
Customer address that was updated. |
errors - [UpdateCustomerAddressError!]!
|
List of response errors when attempting to update an address. |
Example
{
"address": CustomerAddress,
"errors": [CustomerNotLoggedInError]
}
UpdateCustomerError
Description
An error when updating a customer.
Example
EmailAlreadyInUseError
UpdateCustomerInput
Description
The values to use for customer update operation.
Fields
| Input Field | Description |
|---|---|
firstName - String
|
The first name of the customer. |
lastName - String
|
The last name of the customer. |
email - String
|
The email of the customer. |
phone - String
|
The phone number of the customer. |
company - String
|
The company of the customer. |
formFields - CustomerFormFieldsInput
|
The custom form fields that the customer filled out. |
Example
{
"firstName": "abc123",
"lastName": "xyz789",
"email": "xyz789",
"phone": "abc123",
"company": "xyz789",
"formFields": CustomerFormFieldsInput
}
UpdateCustomerResult
Description
The result of updating a customer.
Fields
| Field Name | Description |
|---|---|
customer - Customer
|
The customer that was updated. |
errors - [UpdateCustomerError!]!
|
The errors, if any, that occured during the update operation. |
Example
{
"customer": Customer,
"errors": [EmailAlreadyInUseError]
}
UpdateStockBehavior
Description
The behavior type for updating stock levels.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
Example
"ORDER_COMPLETED_OR_SHIPPED"
UpdateWishlistInput
Description
Update wishlist input object
Fields
| Input Field | Description |
|---|---|
entityId - Int!
|
The wishlist id |
data - WishlistUpdateDataInput!
|
Wishlist data to update |
Example
{"entityId": 987, "data": WishlistUpdateDataInput}
UpdateWishlistResult
Description
Update wishlist
Fields
| Field Name | Description |
|---|---|
result - Wishlist!
|
The wishlist |
Example
{"result": Wishlist}
UrlField
ValidationError
Description
Validation error that occurred during a graphql request
Fields
| Field Name | Description |
|---|---|
path - [String!]!
|
Path to the field that caused the error, if applicable |
message - String!
|
A description of the error |
Example
{
"path": ["abc123"],
"message": "abc123"
}
Variant
Description
Variant
Fields
| Field Name | Description |
|---|---|
id - ID!
|
The ID of an object |
entityId - Int!
|
Id of the variant. |
sku - String!
|
Sku of the variant. |
weight - Measurement
|
The variant's weight. If a weight was not explicitly specified on the variant, this will be the product's weight. |
height - Measurement
|
The variant's height. If a height was not explicitly specified on the variant, this will be the product's height. |
width - Measurement
|
The variant's width. If a width was not explicitly specified on the variant, this will be the product's width. |
depth - Measurement
|
The variant's depth. If a depth was not explicitly specified on the variant, this will be the product's depth. |
options - OptionConnection!
|
The options which define a variant. |
productOptions - ProductOptionConnection!
|
Product options that compose this variant. |
defaultImage - Image
|
Default image for a variant. |
prices - Prices
|
Variant prices |
Arguments
|
|
inventory - VariantInventory
|
Variant inventory |
metafields - MetafieldConnection!
|
Metafield data related to a variant. |
upc - String
|
Universal product code. |
mpn - String
|
Manufacturer part number. |
gtin - String
|
Global trade item number. |
isPurchasable - Boolean!
|
Whether the product can be purchased |
Example
{
"id": "4",
"entityId": 987,
"sku": "xyz789",
"weight": Measurement,
"height": Measurement,
"width": Measurement,
"depth": Measurement,
"options": OptionConnection,
"productOptions": ProductOptionConnection,
"defaultImage": Image,
"prices": Prices,
"inventory": VariantInventory,
"metafields": MetafieldConnection,
"upc": "abc123",
"mpn": "xyz789",
"gtin": "xyz789",
"isPurchasable": true
}
VariantConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [VariantEdge!]
|
A list of edges. |
Example
{
"pageInfo": PageInfo,
"edges": [VariantEdge]
}
VariantEdge
VariantInventory
Description
Variant Inventory
Fields
| Field Name | Description |
|---|---|
aggregated - Aggregated
|
Aggregated product variant inventory information. This data may not be available if not set or if the store's Inventory Settings have disabled displaying stock levels on the storefront. |
isInStock - Boolean!
|
Indicates whether this product is in stock. |
byLocation - LocationConnection
|
Inventory by locations. |
Arguments
|
|
Example
{
"aggregated": Aggregated,
"isInStock": true,
"byLocation": LocationConnection
}
WebPage
Description
WebPage details.
Fields
| Field Name | Description |
|---|---|
entityId - Int!
|
Unique ID for the web page. |
parentEntityId - Int
|
Unique ID for the parent page. |
name - String!
|
Page name. |
isVisibleInNavigation - Boolean!
|
Whether or not the page should be visible in the navigation menu. |
seo - SeoDetails!
|
Page SEO details. |
Possible Types
| WebPage Types |
|---|
Example
{
"entityId": 987,
"parentEntityId": 123,
"name": "abc123",
"isVisibleInNavigation": false,
"seo": SeoDetails
}
WebPageType
Description
Web page type
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"BLOG"
WebPagesFiltersInput
Description
Object containing filters for querying web pages
Fields
| Input Field | Description |
|---|---|
entityIds - [Int!]
|
Ids of the expected pages. |
pageType - WebPageType
|
Type of the expected pages. |
isVisibleInNavigation - Boolean
|
Whether the expected pages are visible in the navigation bar. |
Example
{"entityIds": [123], "pageType": "BLOG", "isVisibleInNavigation": false}
Wishlist
Description
A wishlist
Fields
| Field Name | Description |
|---|---|
entityId - Int!
|
The wishlist id. |
name - String!
|
The wishlist name. |
isPublic - Boolean!
|
Is the wishlist public? |
token - String!
|
The wishlist token. |
items - WishlistItemConnection!
|
A list of the wishlist items |
Arguments
|
|
Example
{
"entityId": 123,
"name": "xyz789",
"isPublic": false,
"token": "abc123",
"items": WishlistItemConnection
}
WishlistConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [WishlistEdge!]
|
A list of edges. |
Example
{
"pageInfo": PageInfo,
"edges": [WishlistEdge]
}
WishlistEdge
WishlistFiltersInput
Description
Wishlist filters input object
Fields
| Input Field | Description |
|---|---|
entityIds - [Int!]
|
A wishlist ids filter. |
Example
{"entityIds": [987]}
WishlistItem
Description
The wishlist item
Example
{
"entityId": 123,
"product": Product,
"productEntityId": 123,
"variantEntityId": 123
}
WishlistItemConnection
Description
A connection to a list of items.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [WishlistItemEdge!]
|
A list of edges. |
Example
{
"pageInfo": PageInfo,
"edges": [WishlistItemEdge]
}
WishlistItemEdge
Description
An edge in a connection.
Fields
| Field Name | Description |
|---|---|
node - WishlistItem!
|
The item at the end of the edge. |
cursor - String!
|
A cursor for use in pagination. |
Example
{
"node": WishlistItem,
"cursor": "abc123"
}
WishlistItemInput
WishlistMutations
Description
The wishlist mutations.
Fields
| Field Name | Description |
|---|---|
createWishlist - CreateWishlistResult
|
Create wishlist |
Arguments
|
|
addWishlistItems - AddWishlistItemsResult
|
Add wishlist items |
Arguments
|
|
deleteWishlistItems - DeleteWishlistItemsResult
|
Delete wishlist items |
Arguments
|
|
updateWishlist - UpdateWishlistResult
|
Update wishlist |
Arguments
|
|
deleteWishlists - DeleteWishlistResult
|
Delete wishlist |
Arguments
|
|
Example
{
"createWishlist": CreateWishlistResult,
"addWishlistItems": AddWishlistItemsResult,
"deleteWishlistItems": DeleteWishlistItemsResult,
"updateWishlist": UpdateWishlistResult,
"deleteWishlists": DeleteWishlistResult
}
WishlistUpdateDataInput
countryCode
Description
Country Code
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"AD"
currencyCode
Description
Currency Code
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"ADP"
sortBy
Description
Blog post sort
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
Example
"NEWEST"