ProductInterface

Contains fields that are common to all types of products.

Fields

Field Name
Description
activity - String
(Deprecated: Use the `custom_attributes` field instead.)
attribute_set_id - Int
The attribute set assigned to the product. (Deprecated: The field should not be used on the storefront.)
canonical_url - String
The relative canonical URL. This value is returned only if the system setting 'Use Canonical Link Meta Tag For Products' is enabled.
categories - [CategoryInterface]
The categories assigned to a product.
category_gear - String
(Deprecated: Use the `custom_attributes` field instead.)
climate - String
(Deprecated: Use the `custom_attributes` field instead.)
collar - String
(Deprecated: Use the `custom_attributes` field instead.)
color - Int
(Deprecated: Use the `custom_attributes` field instead.)
country_of_manufacture - String
The product's country of origin.
created_at - String
Timestamp indicating when the product was created. (Deprecated: The field should not be used on the storefront.)
crosssell_products - [ProductInterface]
An array of cross-sell products.
description - ComplexTextValue
Detailed information about the product. The value can include simple HTML tags.
eco_collection - Int
(Deprecated: Use the `custom_attributes` field instead.)
erin_recommends - Int
(Deprecated: Use the `custom_attributes` field instead.)
features_bags - String
(Deprecated: Use the `custom_attributes` field instead.)
format - Int
(Deprecated: Use the `custom_attributes` field instead.)
gender - String
(Deprecated: Use the `custom_attributes` field instead.)
gift_message_available - String
Indicates whether a gift message is available.
id - Int
The ID number assigned to the product. (Deprecated: Use the `uid` field instead.)
image - ProductImage
The relative path to the main image on the product page.
is_returnable - String
Indicates whether the product can be returned.
manufacturer - Int
A number representing the product's manufacturer. (Deprecated: Use the `custom_attributes` field instead.)
material - String
(Deprecated: Use the `custom_attributes` field instead.)
media_gallery - [MediaGalleryInterface]
An array of media gallery objects.
media_gallery_entries - [MediaGalleryEntry]
An array of MediaGalleryEntry objects. (Deprecated: Use `media_gallery` instead.)
meta_description - String
A brief overview of the product for search results listings, maximum 255 characters.
meta_keyword - String
A comma-separated list of keywords that are visible only to search engines.
meta_title - String
A string that is displayed in the title bar and tab of the browser and in search results lists.
name - String
The product name. Customers use this name to identify the product.
new - Int
(Deprecated: Use the `custom_attributes` field instead.)
new_from_date - String
The beginning date for new product listings, and determines if the product is featured as a new product.
new_to_date - String
The end date for new product listings.
only_x_left_in_stock - Float
Product stock only x left count
options_container - String
If the product has multiple options, determines where they appear on the product page.
pattern - String
(Deprecated: Use the `custom_attributes` field instead.)
performance_fabric - Int
(Deprecated: Use the `custom_attributes` field instead.)
price - ProductPrices
Indicates the price of an item. (Deprecated: Use `price_range` for product price information.)
price_range - PriceRange!
The range of prices for the product
price_tiers - [TierPrice]
An array of `TierPrice` objects.
product_links - [ProductLinksInterface]
An array of `ProductLinks` objects.
purpose - Int
(Deprecated: Use the `custom_attributes` field instead.)
rating_summary - Float!
The average of all the ratings given to the product.
related_products - [ProductInterface]
An array of related products.
review_count - Int!
The total count of all the reviews given to the product.
reviews - ProductReviews!
The list of products reviews.
sale - Int
(Deprecated: Use the `custom_attributes` field instead.)
short_description - ComplexTextValue
A short description of the product. Its use depends on the theme.
size - Int
(Deprecated: Use the `custom_attributes` field instead.)
sku - String
A number or code assigned to a product to identify the product, options, price, and manufacturer.
sleeve - String
(Deprecated: Use the `custom_attributes` field instead.)
small_image - ProductImage
The relative path to the small image, which is used on catalog pages.
special_from_date - String
The beginning date that a product has a special price. (Deprecated: The field should not be used on the storefront.)
special_price - Float
The discounted price of the product.
special_to_date - String
The end date for a product with a special price.
staged - Boolean!
Indicates whether the product is staged for a future campaign.
stock_status - ProductStockStatus
Stock status of the product
strap_bags - String
(Deprecated: Use the `custom_attributes` field instead.)
style_bags - String
(Deprecated: Use the `custom_attributes` field instead.)
style_bottom - String
(Deprecated: Use the `custom_attributes` field instead.)
style_general - String
(Deprecated: Use the `custom_attributes` field instead.)
swatch_image - String
The file name of a swatch image.
thumbnail - ProductImage
The relative path to the product's thumbnail image.
tier_price - Float
The price when tier pricing is in effect and the items purchased threshold has been reached. (Deprecated: Use `price_tiers` for product tier price information.)
tier_prices - [ProductTierPrices]
An array of ProductTierPrices objects. (Deprecated: Use `price_tiers` for product tier price information.)
type_id - String
One of simple, virtual, bundle, downloadable, grouped, or configurable. (Deprecated: Use `__typename` instead.)
uid - ID!
The unique ID for a `ProductInterface` object.
updated_at - String
Timestamp indicating when the product was updated. (Deprecated: The field should not be used on the storefront.)
upsell_products - [ProductInterface]
An array of up-sell products.
url_key - String
The part of the URL that identifies the product
url_path - String
(Deprecated: Use product's `canonical_url` or url rewrites instead)
url_rewrites - [UrlRewrite]
URL rewrites list
url_suffix - String
The part of the product URL that is appended after the url key
websites - [Website]
An array of websites in which the product is available. (Deprecated: The field should not be used on the storefront.)

Possible Types

Example

{
  "activity": "abc123",
  "attribute_set_id": 123,
  "canonical_url": "xyz789",
  "categories": [CategoryInterface],
  "category_gear": "abc123",
  "climate": "abc123",
  "collar": "abc123",
  "color": 987,
  "country_of_manufacture": "abc123",
  "created_at": "abc123",
  "crosssell_products": [ProductInterface],
  "description": ComplexTextValue,
  "eco_collection": 123,
  "erin_recommends": 987,
  "features_bags": "xyz789",
  "format": 123,
  "gender": "xyz789",
  "gift_message_available": "xyz789",
  "id": 123,
  "image": ProductImage,
  "is_returnable": "xyz789",
  "manufacturer": 123,
  "material": "xyz789",
  "media_gallery": [MediaGalleryInterface],
  "media_gallery_entries": [MediaGalleryEntry],
  "meta_description": "abc123",
  "meta_keyword": "xyz789",
  "meta_title": "abc123",
  "name": "abc123",
  "new": 987,
  "new_from_date": "abc123",
  "new_to_date": "xyz789",
  "only_x_left_in_stock": 987.65,
  "options_container": "abc123",
  "pattern": "xyz789",
  "performance_fabric": 987,
  "price": ProductPrices,
  "price_range": PriceRange,
  "price_tiers": [TierPrice],
  "product_links": [ProductLinksInterface],
  "purpose": 123,
  "rating_summary": 123.45,
  "related_products": [ProductInterface],
  "review_count": 123,
  "reviews": ProductReviews,
  "sale": 987,
  "short_description": ComplexTextValue,
  "size": 123,
  "sku": "xyz789",
  "sleeve": "abc123",
  "small_image": ProductImage,
  "special_from_date": "abc123",
  "special_price": 987.65,
  "special_to_date": "xyz789",
  "staged": true,
  "stock_status": "IN_STOCK",
  "strap_bags": "abc123",
  "style_bags": "abc123",
  "style_bottom": "xyz789",
  "style_general": "xyz789",
  "swatch_image": "xyz789",
  "thumbnail": ProductImage,
  "tier_price": 123.45,
  "tier_prices": [ProductTierPrices],
  "type_id": "xyz789",
  "uid": "4",
  "updated_at": "xyz789",
  "upsell_products": [ProductInterface],
  "url_key": "xyz789",
  "url_path": "xyz789",
  "url_rewrites": [UrlRewrite],
  "url_suffix": "abc123",
  "websites": [Website]
}

An implementation of ProductLinksInterface.

Fields

Field Name
Description
link_type - String
One of related, associated, upsell, or crosssell.
linked_product_sku - String
The SKU of the linked product.
linked_product_type - String
The type of linked product (simple, virtual, bundle, downloadable, grouped, configurable).
position - Int
The position within the list of product links.
sku - String
The identifier of the linked product.

Example

{
  "link_type": "xyz789",
  "linked_product_sku": "abc123",
  "linked_product_type": "abc123",
  "position": 123,
  "sku": "xyz789"
}

ProductLinksInterface

Contains information about linked products, including the link type and product type of each item.

Fields

Field Name
Description
link_type - String
One of related, associated, upsell, or crosssell.
linked_product_sku - String
The SKU of the linked product.
linked_product_type - String
The type of linked product (simple, virtual, bundle, downloadable, grouped, configurable).
position - Int
The position within the list of product links.
sku - String
The identifier of the linked product.

Possible Types

ProductLinksInterface Types
ProductLinks

Example

{
  "link_type": "xyz789",
  "linked_product_sku": "xyz789",
  "linked_product_type": "abc123",
  "position": 987,
  "sku": "abc123"
}

ProductMediaGalleryEntriesContent

Contains an image in base64 format and basic information about the image.

Fields

Field Name
Description
base64_encoded_data - String
The image in base64 format.
name - String
The file name of the image.
type - String
The MIME type of the file, such as image/png.

Example

{
  "base64_encoded_data": "xyz789",
  "name": "abc123",
  "type": "abc123"
}

ProductMediaGalleryEntriesVideoContent

Contains a link to a video file and basic information about the video.

Fields

Field Name
Description
media_type - String
Must be external-video.
video_description - String
A description of the video.
video_metadata - String
Optional data about the video.
video_provider - String
Describes the video source.
video_title - String
The title of the video.
video_url - String
The URL to the video.

Example

{
  "media_type": "abc123",
  "video_description": "xyz789",
  "video_metadata": "xyz789",
  "video_provider": "xyz789",
  "video_title": "abc123",
  "video_url": "xyz789"
}

ProductPrice

Represents a product price.

Fields

Field Name
Description
discount - ProductDiscount
The price discount. Represents the difference between the regular and final price.
final_price - Money!
The final price of the product after applying discounts.
fixed_product_taxes - [FixedProductTax]
An array of the multiple Fixed Product Taxes that can be applied to a product price.
regular_price - Money!
The regular price of the product.

Example

{
  "discount": ProductDiscount,
  "final_price": Money,
  "fixed_product_taxes": [FixedProductTax],
  "regular_price": Money
}

ProductPrices

Deprecated. Use PriceRange instead. Contains the regular price of an item, as well as its minimum and maximum prices. Only composite products, which include bundle, configurable, and grouped products, can contain a minimum and maximum price.

Fields

Field Name
Description
maximalPrice - Price
The highest possible final price for all the options defined within a composite product. If you are specifying a price range, this would be the `to` value. (Deprecated: Use `PriceRange.maximum_price` instead.)
minimalPrice - Price
The lowest possible final price for all the options defined within a composite product. If you are specifying a price range, this would be the `from` value. (Deprecated: Use `PriceRange.minimum_price` instead.)
regularPrice - Price
The base price of a product. (Deprecated: Use `regular_price` from `PriceRange.minimum_price` or `PriceRange.maximum_price` instead.)

Example

{
  "maximalPrice": Price,
  "minimalPrice": Price,
  "regularPrice": Price
}

ProductReview

Contains details of a product review.

Fields

Field Name
Description
average_rating - Float!
The average of all ratings for this product.
created_at - String!
The date the review was created.
nickname - String!
The customer's nickname. Defaults to the customer name, if logged in.
product - ProductInterface!
The reviewed product.
ratings_breakdown - [ProductReviewRating]!
An array of ratings by rating category, such as quality, price, and value.
summary - String!
The summary (title) of the review.
text - String!
The review text.

Example

{
  "average_rating": 123.45,
  "created_at": "xyz789",
  "nickname": "abc123",
  "product": ProductInterface,
  "ratings_breakdown": [ProductReviewRating],
  "summary": "abc123",
  "text": "xyz789"
}

ProductReviewRating

Contains data about a single aspect of a product review.

Fields

Field Name
Description
name - String!
The label assigned to an aspect of a product that is being rated, such as quality or price.
value - String!
The rating value given by customer. By default, possible values range from 1 to 5.

Example

{
  "name": "xyz789",
  "value": "abc123"
}

ProductReviewRatingInput

Contains the reviewer's rating for a single aspect of a review.

Input Fields

Input Field
Description
id - String!
An encoded rating ID.
value_id - String!
An encoded rating value ID.

Example

{
  "id": "xyz789",
  "value_id": "abc123"
}

ProductReviewRatingMetadata

Contains details about a single aspect of a product review.

Fields

Field Name
Description
id - String!
An encoded rating ID.
name - String!
The label assigned to an aspect of a product that is being rated, such as quality or price.
values - [ProductReviewRatingValueMetadata]!
List of product review ratings sorted by position.

Example

{
  "id": "abc123",
  "name": "abc123",
  "values": [ProductReviewRatingValueMetadata]
}

ProductReviewRatingValueMetadata

Contains details about a single value in a product review.

Fields

Field Name
Description
value - String!
A ratings scale, such as the number of stars awarded.
value_id - String!
An encoded rating value ID.

Example

{
  "value": "abc123",
  "value_id": "xyz789"
}

ProductReviewRatingsMetadata

Contains an array of metadata about each aspect of a product review.

Fields

Field Name
Description
items - [ProductReviewRatingMetadata]!
An array of product reviews sorted by position.

Example

{"items": [ProductReviewRatingMetadata]}

ProductReviews

Contains an array of product reviews.

Fields

Field Name
Description
items - [ProductReview]!
An array of product reviews.
page_info - SearchResultPageInfo!
Metadata for pagination rendering.

Example

{
  "items": [ProductReview],
  "page_info": SearchResultPageInfo
}

ProductStockStatus

This enumeration states whether a product stock status is in stock or out of stock

Values

Enum Value
Description
IN_STOCK
OUT_OF_STOCK

Example

""IN_STOCK""

ProductTierPrices

Deprecated. Use TierPrice instead. Defines a tier price, which is a quantity discount offered to a specific customer group.

Fields

Field Name
Description
customer_group_id - String
The ID of the customer group. (Deprecated: Not relevant for the storefront.)
percentage_value - Float
The percentage discount of the item. (Deprecated: Use `TierPrice.discount` instead.)
qty - Float
The number of items that must be purchased to qualify for tier pricing. (Deprecated: Use `TierPrice.quantity` instead.)
value - Float
The price of the fixed price item. (Deprecated: Use `TierPrice.final_price` instead.)
website_id - Float
The ID assigned to the website. (Deprecated: Not relevant for the storefront.)

Example

{
  "customer_group_id": "abc123",
  "percentage_value": 123.45,
  "qty": 987.65,
  "value": 123.45,
  "website_id": 123.45
}

ProductVideo

Contains information about a product video.

Fields

Field Name
Description
disabled - Boolean
Indicates whether the image is hidden from view.
label - String
The label of the product image or video.
position - Int
The media item's position after it has been sorted.
url - String
The URL of the product image or video.
video_content - ProductMediaGalleryEntriesVideoContent
Contains a `ProductMediaGalleryEntriesVideoContent` object.

Example

{
  "disabled": false,
  "label": "abc123",
  "position": 987,
  "url": "abc123",
  "video_content": ProductMediaGalleryEntriesVideoContent
}

Products

Contains the results of a products query.

Fields

Field Name
Description
aggregations - [Aggregation]
A bucket that contains the attribute code and label for each filterable option.
filters - [LayerFilter]
Layered navigation filters array. (Deprecated: Use `aggregations` instead.)
items - [ProductInterface]
An array of products that match the specified search criteria.
page_info - SearchResultPageInfo
An object that includes the page_info and currentPage values specified in the query.
sort_fields - SortFields
An object that includes the default sort field and all available sort fields.
suggestions - [SearchSuggestion]
An array of search suggestions for case when search query have no results.
total_count - Int
The number of products that are marked as visible. By default, in complex products, parent products are visible, but their child products are not.

Example

{
  "aggregations": [Aggregation],
  "filters": [LayerFilter],
  "items": [ProductInterface],
  "page_info": SearchResultPageInfo,
  "sort_fields": SortFields,
  "suggestions": [SearchSuggestion],
  "total_count": 987
}

PurchaseOrder

Contains details about a purchase order.

Fields

Field Name
Description
approval_flow - [PurchaseOrderRuleApprovalFlow]!
The approval flows for each applied rules.
available_actions - [PurchaseOrderAction]!
Purchase order actions available to the customer. Can be used to display action buttons on the client.
comments - [PurchaseOrderComment]!
The set of comments applied to the purchase order.
created_at - String!
The date the purchase order was created.
created_by - Customer
The company user who created the purchase order.
history_log - [PurchaseOrderHistoryItem]!
The log of the events related to the purchase order.
number - String!
The purchase order number.
order - CustomerOrder
The reference to the order placed based on the purchase order.
quote - Cart
The quote related to the purchase order.
status - PurchaseOrderStatus!
The current status of the purchase order.
uid - ID!
A unique identifier for the purchase order.
updated_at - String!
The date the purchase order was last updated.

Example

{
  "approval_flow": [PurchaseOrderRuleApprovalFlow],
  "available_actions": ["REJECT"],
  "comments": [PurchaseOrderComment],
  "created_at": "xyz789",
  "created_by": Customer,
  "history_log": [PurchaseOrderHistoryItem],
  "number": "xyz789",
  "order": CustomerOrder,
  "quote": Cart,
  "status": "PENDING",
  "uid": 4,
  "updated_at": "xyz789"
}

PurchaseOrderAction

Values

Enum Value
Description
REJECT
CANCEL
VALIDATE
APPROVE
PLACE_ORDER

Example

""REJECT""

PurchaseOrderActionError

Contains details about a failed action.

Fields

Field Name
Description
message - String!
The returned error message.
type - PurchaseOrderErrorType!
The error type.

Example

{"message": "xyz789", "type": "NOT_FOUND"}

PurchaseOrderApprovalFlowEvent

Contains details about a single event in the approval flow of the purchase order.

Fields

Field Name
Description
message - String
A formatted message.
name - String
The approver name.
role - String
The approver role.
status - PurchaseOrderApprovalFlowItemStatus
The status related to the event.
updated_at - String
The date and time the event was updated.

Example

{
  "message": "xyz789",
  "name": "abc123",
  "role": "abc123",
  "status": "PENDING",
  "updated_at": "abc123"
}

PurchaseOrderApprovalFlowItemStatus

Values

Enum Value
Description
PENDING
APPROVED
REJECTED

Example

""PENDING""

PurchaseOrderApprovalRule

Contains details about a purchase order approval rule.

Fields

Field Name
Description
applies_to_roles - [CompanyRole]!
The name of the user(s) affected by the the purchase order approval rule.
approver_roles - [CompanyRole]!
The name of the user who needs to approve purchase orders that trigger the approval rule.
condition - PurchaseOrderApprovalRuleConditionInterface
Condition which triggers the approval rule.
created_at - String!
The date the purchase order rule was created.
created_by - String!
The name of the user who created the purchase order approval rule.
description - String
Description of the purchase order approval rule.
name - String!
The name of the purchase order approval rule.
status - PurchaseOrderApprovalRuleStatus!
The status of the purchase order approval rule.
uid - ID!
The unique identifier for the purchase order approval rule.
updated_at - String!
The date the purchase order rule was last updated.

Example

{
  "applies_to_roles": [CompanyRole],
  "approver_roles": [CompanyRole],
  "condition": PurchaseOrderApprovalRuleConditionInterface,
  "created_at": "xyz789",
  "created_by": "abc123",
  "description": "xyz789",
  "name": "abc123",
  "status": "ENABLED",
  "uid": "4",
  "updated_at": "abc123"
}

PurchaseOrderApprovalRuleConditionAmount

Contains approval rule condition details, including the amount to be evaluated.

Fields

Field Name
Description
amount - Money!
The amount to be be used for evaluation of the approval rule condition.
attribute - PurchaseOrderApprovalRuleType
The type of purchase order approval rule.
operator - PurchaseOrderApprovalRuleConditionOperator
The operator to be used for evaluating the approval rule condition.

Example

{
  "amount": Money,
  "attribute": "GRAND_TOTAL",
  "operator": "MORE_THAN"
}

PurchaseOrderApprovalRuleConditionInterface

Purchase order rule condition details.

Fields

Field Name
Description
attribute - PurchaseOrderApprovalRuleType
The type of purchase order approval rule.
operator - PurchaseOrderApprovalRuleConditionOperator
The operator to be used for evaluating the approval rule condition.

Possible Types

Example

{"attribute": "GRAND_TOTAL", "operator": "MORE_THAN"}

PurchaseOrderApprovalRuleConditionOperator

Values

Enum Value
Description
MORE_THAN
LESS_THAN
MORE_THAN_OR_EQUAL_TO
LESS_THAN_OR_EQUAL_TO

Example

""MORE_THAN""

PurchaseOrderApprovalRuleConditionQuantity

Contains approval rule condition details, including the quantity to be evaluated.

Fields

Field Name
Description
attribute - PurchaseOrderApprovalRuleType
The type of purchase order approval rule.
operator - PurchaseOrderApprovalRuleConditionOperator
The operator to be used for evaluating the approval rule condition.
quantity - Int
The quantity to be used for evaluation of the approval rule condition.

Example

{"attribute": "GRAND_TOTAL", "operator": "MORE_THAN", "quantity": 123}

PurchaseOrderApprovalRuleInput

Defines a new purchase order approval rule.

Input Fields

Input Field
Description
applies_to - [ID]!
A list of company user role IDs to which this purchase order approval rule should be applied. When an empty array is provided, the rule is applied to all user roles in the system, including those created in the future.
approvers - [ID]!
A list of B2B user roles that can approve this purchase order approval rule.
condition - CreatePurchaseOrderApprovalRuleConditionInput!
The condition of the purchase order approval rule.
description - String
A summary of the purpose of the purchase order approval rule.
name - String!
The purchase order approval rule name.
status - PurchaseOrderApprovalRuleStatus!
The status of the purchase order approval rule.

Example

{
  "applies_to": [4],
  "approvers": ["4"],
  "condition": CreatePurchaseOrderApprovalRuleConditionInput,
  "description": "xyz789",
  "name": "abc123",
  "status": "ENABLED"
}

PurchaseOrderApprovalRuleMetadata

Contains metadata that can be used to render rule edit forms.

Fields

Field Name
Description
available_applies_to - [CompanyRole]!
A list of B2B user roles that the rule can be applied to.
available_condition_currencies - [AvailableCurrency]!
A list of currencies that can be used to create approval rules based on amounts, for example shipping cost rules.
available_requires_approval_from - [CompanyRole]!
A list of B2B user roles that can be specified as approvers for the approval rules.

Example

{
  "available_applies_to": [CompanyRole],
  "available_condition_currencies": [AvailableCurrency],
  "available_requires_approval_from": [CompanyRole]
}

PurchaseOrderApprovalRuleStatus

Values

Enum Value
Description
ENABLED
DISABLED

Example

""ENABLED""

PurchaseOrderApprovalRuleType

Values

Enum Value
Description
GRAND_TOTAL
SHIPPING_INCL_TAX
NUMBER_OF_SKUS

Example

""GRAND_TOTAL""

PurchaseOrderApprovalRules

Contains the approval rules that the customer can see.

Fields

Field Name
Description
items - [PurchaseOrderApprovalRule]!
A list of purchase order approval rules visible to the customer.
page_info - SearchResultPageInfo
Result pagination details.
total_count - Int
The total number of purchase order approval rules visible to the customer.

Example

{
  "items": [PurchaseOrderApprovalRule],
  "page_info": SearchResultPageInfo,
  "total_count": 123
}

PurchaseOrderComment

Contains details about a comment.

Fields

Field Name
Description
author - Customer
The user who left the comment.
created_at - String!
The date and time when the comment was created.
text - String!
The text of the comment.
uid - ID!
A unique identifier of the comment.

Example

{
  "author": Customer,
  "created_at": "xyz789",
  "text": "xyz789",
  "uid": "4"
}

PurchaseOrderErrorType

Values

Enum Value
Description
NOT_FOUND
OPERATION_NOT_APPLICABLE
COULD_NOT_SAVE
NOT_VALID_DATA
UNDEFINED

Example

""NOT_FOUND""

PurchaseOrderHistoryItem

Contains details about a status change.

Fields

Field Name
Description
activity - String!
The activity type of the event.
created_at - String!
The date and time when the event happened.
message - String!
The message representation of the event.
uid - ID!
A unique identifier of the purchase order history item.

Example

{
  "activity": "abc123",
  "created_at": "abc123",
  "message": "xyz789",
  "uid": 4
}

PurchaseOrderRuleApprovalFlow

Contains details about approval roles applied to the purchase order and status changes.

Fields

Field Name
Description
events - [PurchaseOrderApprovalFlowEvent]!
The approval flow event related to the rule.
rule_name - String!
The name of the applied rule.

Example

{
  "events": [PurchaseOrderApprovalFlowEvent],
  "rule_name": "abc123"
}

PurchaseOrderStatus

Values

Enum Value
Description
PENDING
APPROVAL_REQUIRED
APPROVED
ORDER_IN_PROGRESS
ORDER_PLACED
ORDER_FAILED
REJECTED
CANCELED
APPROVED_PENDING_PAYMENT

Example

""PENDING""

PurchaseOrders

Contains a list of purchase orders.

Fields

Field Name
Description
items - [PurchaseOrder]!
Purchase orders matching the search criteria.
page_info - SearchResultPageInfo
Page information of search result's current page.
total_count - Int
Total number of purchase orders found matching the search criteria.

Example

{
  "items": [PurchaseOrder],
  "page_info": SearchResultPageInfo,
  "total_count": 987
}

PurchaseOrdersActionInput

Defines which purchase orders to act on.

Input Fields

Input Field
Description
purchase_order_uids - [ID]!
An array of of purchase order UIDs.

Example

{"purchase_order_uids": ["4"]}

PurchaseOrdersActionOutput

Returns a list of updated purchase orders and any error messages.

Fields

Field Name
Description
errors - [PurchaseOrderActionError]!
An array of error messages encountered while performing the operation.
purchase_orders - [PurchaseOrder]!
A list of purchase orders.

Example

{
  "errors": [PurchaseOrderActionError],
  "purchase_orders": [PurchaseOrder]
}

PurchaseOrdersFilterInput

Defines the criteria to use to filter the list of purchase orders.

Input Fields

Input Field
Description
company_purchase_orders - Boolean
Include only purchase orders made by subordinate company users.
created_date - FilterRangeTypeInput
Filter by the creation date of the purchase order.
require_my_approval - Boolean
Include only purchase orders that are waiting for the customer’s approval.
status - PurchaseOrderStatus
Filter by the status of the purchase order.

Example

{
  "company_purchase_orders": true,
  "created_date": FilterRangeTypeInput,
  "require_my_approval": true,
  "status": "PENDING"
}

Region

Fields

Field Name
Description
code - String
The two-letter code for the region, such as TX for Texas.
id - Int
The unique ID for a `Region` object.
name - String
The name of the region, such as Texas.

Example

{
  "code": "abc123",
  "id": 123,
  "name": "xyz789"
}

RemoveCouponFromCartInput

Specifies the cart from which to remove a coupon.

Input Fields

Input Field
Description
cart_id - String!
The unique ID of a `Cart` object.

Example

{"cart_id": "xyz789"}

RemoveCouponFromCartOutput

Contains details about the cart after removing a coupon.

Fields

Field Name
Description
cart - Cart
The cart after removing a coupon.

Example

{"cart": Cart}

RemoveGiftCardFromCartInput

Defines the input required to run the removeGiftCardFromCart mutation.

Input Fields

Input Field
Description
cart_id - String!
The unique ID that identifies the customer's cart.
gift_card_code - String!
The gift card code to be removed to the cart.

Example

{
  "cart_id": "xyz789",
  "gift_card_code": "abc123"
}

RemoveGiftCardFromCartOutput

Defines the possible output for the removeGiftCardFromCart mutation.

Fields

Field Name
Description
cart - Cart!
The contents of the specified shopping cart.

Example

{"cart": Cart}

RemoveGiftRegistryItemsOutput

Contains the results of a request to remove an item from a gift registry.

Fields

Field Name
Description
gift_registry - GiftRegistry
The gift registry after removing items.

Example

{"gift_registry": GiftRegistry}

RemoveGiftRegistryOutput

Contains the results of a request to delete a gift registry.

Fields

Field Name
Description
success - Boolean!
Indicates whether the gift registry was successfully deleted.

Example

{"success": true}

RemoveGiftRegistryRegistrantsOutput

Contains the results of a request to delete a registrant.

Fields

Field Name
Description
gift_registry - GiftRegistry
The gift registry after deleting registrants.

Example

{"gift_registry": GiftRegistry}

RemoveItemFromCartInput

Specifies which items to remove from the cart.

Input Fields

Input Field
Description
cart_id - String!
The unique ID of a `Cart` object.
cart_item_id - Int
Deprecated. Use `cart_item_uid` instead.
cart_item_uid - ID
Required field. The unique ID for a `CartItemInterface` object.

Example

{
  "cart_id": "xyz789",
  "cart_item_id": 123,
  "cart_item_uid": 4
}

RemoveItemFromCartOutput

Contains details about the cart after removing an item.

Fields

Field Name
Description
cart - Cart!
The cart after removing an item.

Example

{"cart": Cart}

RemoveNegotiableQuoteItemsInput

Defines the items to remove from the specified negotiable quote.

Input Fields

Input Field
Description
quote_item_uids - [ID]!
An array of IDs indicating which items to remove from the negotiable quote.
quote_uid - ID!
The unique ID of a `NegotiableQuote` object.

Example

{"quote_item_uids": [4], "quote_uid": "4"}

RemoveNegotiableQuoteItemsOutput

Contains the negotiable quote.

Fields

Field Name
Description
quote - NegotiableQuote
The negotiable quote after removing items.

Example

{"quote": NegotiableQuote}

RemoveProductsFromCompareListInput

Defines which products to remove from a compare list.

Input Fields

Input Field
Description
products - [ID]!
An array of product IDs to remove from the compare list.
uid - ID!
The unique identifier of the compare list to modify.

Example

{"products": ["4"], "uid": 4}

RemoveProductsFromWishlistOutput

Contains the customer's wish list and any errors encountered.

Fields

Field Name
Description
user_errors - [WishListUserInputError]!
An array of errors encountered while deleting products from a wish list.
wishlist - Wishlist!
Contains the wish list with after items were successfully deleted.

Example

{
  "user_errors": [WishListUserInputError],
  "wishlist": Wishlist
}

RemoveReturnTrackingInput

Defines the tracking information to delete.

Input Fields

Input Field
Description
return_shipping_tracking_uid - ID!
The unique ID for a `ReturnShippingTracking` object.

Example

{"return_shipping_tracking_uid": 4}

RemoveReturnTrackingOutput

Contains the response after deleting tracking information.

Fields

Field Name
Description
return - Return
Contains details about the modified return.

Example

{"return": Return}

RemoveRewardPointsFromCartOutput

Contains the customer cart.

Fields

Field Name
Description
cart - Cart!
The customer cart after reward points are removed.

Example

{"cart": Cart}

RemoveStoreCreditFromCartInput

Defines the input required to run the removeStoreCreditFromCart mutation.

Input Fields

Input Field
Description
cart_id - String!
The unique ID that identifies the customer's cart.

Example

{"cart_id": "xyz789"}

RemoveStoreCreditFromCartOutput

Defines the possible output for the removeStoreCreditFromCart mutation.

Fields

Field Name
Description
cart - Cart!
The contents of the specified shopping cart.

Example

{"cart": Cart}

ReorderItemsOutput

Contains the cart and any errors after adding products.

Fields

Field Name
Description
cart - Cart!
Detailed information about the customer's cart.
userInputErrors - [CheckoutUserInputError]!
An array of reordering errors.

Example

{
  "cart": Cart,
  "userInputErrors": [CheckoutUserInputError]
}

RequestNegotiableQuoteInput

Defines properties of a negotiable quote request.

Input Fields

Input Field
Description
cart_id - ID!
The cart ID of the buyer requesting a new negotiable quote.
comment - NegotiableQuoteCommentInput!
Comments the buyer entered to describe the request.
quote_name - String!
The name the buyer assigned to the negotiable quote request.

Example

{
  "cart_id": "4",
  "comment": NegotiableQuoteCommentInput,
  "quote_name": "abc123"
}

RequestNegotiableQuoteOutput

Contains the NegotiableQuote object generated when a buyer requests a negotiable quote.

Fields

Field Name
Description
quote - NegotiableQuote
Details about the negotiable quote.

Example

{"quote": NegotiableQuote}

RequestReturnInput

Contains information needed to start a return request.

Input Fields

Input Field
Description
comment_text - String
Text the buyer entered that describes the reason for the refund request.
contact_email - String
The email address the buyer enters to receive notifications about the status of the return.
items - [RequestReturnItemInput]!
An array of items to be returned.
order_uid - ID!
The unique ID for a `Order` object.

Example

{
  "comment_text": "xyz789",
  "contact_email": "xyz789",
  "items": [RequestReturnItemInput],
  "order_uid": "4"
}

RequestReturnItemInput

Contains details about an item to be returned.

Input Fields

Input Field
Description
entered_custom_attributes - [EnteredCustomAttributeInput]
Details about a custom attribute that was entered.
order_item_uid - ID!
The unique ID for a `OrderItemInterface` object.
quantity_to_return - Float!
The quantity of the item to be returned.
selected_custom_attributes - [SelectedCustomAttributeInput]
An array of selected custom option IDs associated with the item to be returned. For example, the IDs for the selected color and size of a configurable product.

Example

{
  "entered_custom_attributes": [
    EnteredCustomAttributeInput
  ],
  "order_item_uid": "4",
  "quantity_to_return": 987.65,
  "selected_custom_attributes": [
    SelectedCustomAttributeInput
  ]
}

RequestReturnOutput

Contains the response to a return request.

Fields

Field Name
Description
return - Return
Details about a single return request.
returns - Returns
An array of return requests.

Example

{
  "return": Return,
  "returns": Returns
}

RequisitionList

Defines the contents of a requisition list.

Fields

Field Name
Description
description - String
Optional text that describes the requisition list.
items - RequistionListItems
An array of products added to the requisition list.
items_count - Int!
The number of items in the list.
name - String!
The requisition list name.
uid - ID!
The unique requisition list ID.
updated_at - String
The time of the last modification of the requisition list.

Example

{
  "description": "abc123",
  "items": RequistionListItems,
  "items_count": 987,
  "name": "abc123",
  "uid": "4",
  "updated_at": "abc123"
}

RequisitionListFilterInput

Defines requisition list filters.

Input Fields

Input Field
Description
name - FilterMatchTypeInput
Filter by the display name of the requisition list.
uids - FilterEqualTypeInput
Filter requisition lists by one or more requisition list IDs.

Example

{
  "name": FilterMatchTypeInput,
  "uids": FilterEqualTypeInput
}

RequisitionListItemInterface

The interface for requisition list items.

Fields

Field Name
Description
customizable_options - [SelectedCustomizableOption]!
Selected custom options for an item in the requisition list.
product - ProductInterface!
Details about a requisition list item.
quantity - Float!
The amount added.
uid - ID!
The unique ID for the requisition list item.

Possible Types

Example

{
  "customizable_options": [SelectedCustomizableOption],
  "product": ProductInterface,
  "quantity": 123.45,
  "uid": 4
}

RequisitionListItemsInput

Defines the items to add.

Input Fields

Input Field
Description
entered_options - [EnteredOptionInput]
Entered option IDs.
parent_sku - String
For configurable products, the SKU of the parent product.
quantity - Float
The quantity of the product to add.
selected_options - [String]
Selected option IDs.
sku - String!
The product SKU.

Example

{
  "entered_options": [EnteredOptionInput],
  "parent_sku": "xyz789",
  "quantity": 987.65,
  "selected_options": ["abc123"],
  "sku": "xyz789"
}

RequisitionLists

Defines customer requisition lists.

Fields

Field Name
Description
items - [RequisitionList]
An array of requisition lists.
page_info - SearchResultPageInfo
Pagination metadata.
total_count - Int
The number of returned requisition lists.

Example

{
  "items": [RequisitionList],
  "page_info": SearchResultPageInfo,
  "total_count": 123
}

RequistionListItems

Contains an array of items added to a requisition list.

Fields

Field Name
Description
items - [RequisitionListItemInterface]!
An array of items in the requisition list.
page_info - SearchResultPageInfo
Pagination metadata.
total_pages - Int!
The number of pages returned.

Example

{
  "items": [RequisitionListItemInterface],
  "page_info": SearchResultPageInfo,
  "total_pages": 123
}

Return

Contains details about a return.

Fields

Field Name
Description
available_shipping_carriers - [ReturnShippingCarrier]
A list of shipping carriers available for returns.
comments - [ReturnComment]
A list of comments posted for the return request.
created_at - String!
The date the return was requested.
customer - ReturnCustomer!
Data from the customer who created the return request.
items - [ReturnItem]
A list of items being returned.
number - String!
A human-readable return number.
order - CustomerOrder
The order associated with the return.
shipping - ReturnShipping
Shipping information for the return.
status - ReturnStatus
The status of the return request.
uid - ID!
The unique ID for a `Return` object.

Example

{
  "available_shipping_carriers": [ReturnShippingCarrier],
  "comments": [ReturnComment],
  "created_at": "xyz789",
  "customer": ReturnCustomer,
  "items": [ReturnItem],
  "number": "abc123",
  "order": CustomerOrder,
  "shipping": ReturnShipping,
  "status": "PENDING",
  "uid": 4
}

ReturnComment

Contains details about a return comment.

Fields

Field Name
Description
author_name - String!
The name or author who posted the comment.
created_at - String!
The date and time the comment was posted.
text - String!
The contents of the comment.
uid - ID!
The unique ID for a `ReturnComment` object.

Example

{
  "author_name": "abc123",
  "created_at": "xyz789",
  "text": "xyz789",
  "uid": 4
}

ReturnCustomAttribute

Contains details about a ReturnCustomerAttribute object.

Fields

Field Name
Description
label - String!
A description of the attribute.
uid - ID!
The unique ID for a `ReturnCustomAttribute` object.
value - String!
A JSON-encoded value of the attribute.

Example

{
  "label": "abc123",
  "uid": "4",
  "value": "xyz789"
}

ReturnCustomer

The customer information for the return.

Fields

Field Name
Description
email - String!
The email address of the customer.
firstname - String
The first name of the customer.
lastname - String
The last name of the customer.

Example

{
  "email": "abc123",
  "firstname": "xyz789",
  "lastname": "xyz789"
}

ReturnItem

Contains details about a product being returned.

Fields

Field Name
Description
custom_attributes - [ReturnCustomAttribute]
Return item custom attributes that are visible on the storefront.
order_item - OrderItemInterface!
Provides access to the product being returned, including information about selected and entered options.
quantity - Float!
The quantity of the item the merchant authorized to be returned.
request_quantity - Float!
The quantity of the item requested to be returned.
status - ReturnItemStatus!
The return status of the item.
uid - ID!
The unique ID for a `ReturnItem` object.

Example

{
  "custom_attributes": [ReturnCustomAttribute],
  "order_item": OrderItemInterface,
  "quantity": 123.45,
  "request_quantity": 987.65,
  "status": "PENDING",
  "uid": "4"
}

ReturnItemStatus

Values

Enum Value
Description
PENDING
AUTHORIZED
RECEIVED
APPROVED
REJECTED
DENIED

Example

""PENDING""

ReturnShipping

Contains details about the return shipping address.

Fields

Field Name
Description
address - ReturnShippingAddress
The merchant-defined return shipping address.
tracking - [ReturnShippingTracking]
The unique ID for a `ReturnShippingTracking` object. If a single UID is specified, the array contains a single tracking record. Otherwise, array contains all tracking information.

Example

{
  "address": ReturnShippingAddress,
  "tracking": [ReturnShippingTracking]
}

ReturnShippingAddress

Contains details about the shipping address used for receiving returned items.

Fields

Field Name
Description
city - String!
The city for product returns.
contact_name - String
The merchant's contact person.
country - Country!
An object that defines the country for product returns.
postcode - String!
The postal code for product returns.
region - Region!
An object that defines the state or province for product returns.
street - [String]!
The street address for product returns.
telephone - String
The telephone number for product returns.

Example

{
  "city": "abc123",
  "contact_name": "xyz789",
  "country": Country,
  "postcode": "abc123",
  "region": Region,
  "street": ["abc123"],
  "telephone": "abc123"
}

ReturnShippingCarrier

Contains details about the carrier on a return.

Fields

Field Name
Description
label - String!
A description of the shipping carrier.
uid - ID!
The unique ID for a `ReturnShippingCarrier` object assigned to the shipping carrier.

Example

{"label": "abc123", "uid": 4}

ReturnShippingTracking

Contains shipping and tracking details.

Fields

Field Name
Description
carrier - ReturnShippingCarrier!
Contains details of a shipping carrier.
status - ReturnShippingTrackingStatus
Details about the status of a shipment.
tracking_number - String!
A tracking number assigned by the carrier.
uid - ID!
The unique ID for a `ReturnShippingTracking` object assigned to the tracking item.

Example

{
  "carrier": ReturnShippingCarrier,
  "status": ReturnShippingTrackingStatus,
  "tracking_number": "xyz789",
  "uid": 4
}

ReturnShippingTrackingStatus

Contains the status of a shipment.

Fields

Field Name
Description
text - String!
Text that describes the status.
type - ReturnShippingTrackingStatusType!
Indicates whether the status type is informational or an error.

Example

{"text": "xyz789", "type": "INFORMATION"}

ReturnShippingTrackingStatusType

Values

Enum Value
Description
INFORMATION
ERROR

Example

""INFORMATION""

ReturnStatus

Values

Enum Value
Description
PENDING
AUTHORIZED
PARTIALLY_AUTHORIZED
RECEIVED
PARTIALLY_RECEIVED
APPROVED
PARTIALLY_APPROVED
REJECTED
PARTIALLY_REJECTED
DENIED
PROCESSED_AND_CLOSED
CLOSED

Example

""PENDING""

Returns

Contains a list of customer return requests.

Fields

Field Name
Description
items - [Return]
A list of return requests.
page_info - SearchResultPageInfo
Pagination metadata.
total_count - Int
The total number of return requests.

Example

{
  "items": [Return],
  "page_info": SearchResultPageInfo,
  "total_count": 987
}

RevokeCustomerTokenOutput

Contains the result of a request to revoke a customer token.

Fields

Field Name
Description
result - Boolean!
The result of a request to revoke a customer token.

Example

{"result": true}

RewardPoints

Contains details about a customer's reward points.

Fields

Field Name
Description
balance - RewardPointsAmount
The current balance of reward points.
balance_history - [RewardPointsBalanceHistoryItem]
The balance history of reward points. If the ability for customers to view the balance history has been disabled in the Admin, this field will be set to null.
exchange_rates - RewardPointsExchangeRates
The current exchange rates for reward points.
subscription_status - RewardPointsSubscriptionStatus
The subscription status of emails related to reward points.

Example

{
  "balance": RewardPointsAmount,
  "balance_history": [RewardPointsBalanceHistoryItem],
  "exchange_rates": RewardPointsExchangeRates,
  "subscription_status": RewardPointsSubscriptionStatus
}

RewardPointsAmount

Fields

Field Name
Description
money - Money!
The reward points amount in store currency.
points - Float!
The reward points amount in points.

Example

{"money": Money, "points": 987.65}

RewardPointsBalanceHistoryItem

Contain details about the reward points transaction.

Fields

Field Name
Description
balance - RewardPointsAmount
The award points balance after the completion of the transaction.
change_reason - String!
The reason the balance changed.
date - String!
The date of the transaction.
points_change - Float!
The number of points added or deducted in the transaction.

Example

{
  "balance": RewardPointsAmount,
  "change_reason": "abc123",
  "date": "abc123",
  "points_change": 987.65
}

RewardPointsExchangeRates

Lists the reward points exchange rates. The values depend on the customer group.

Fields

Field Name
Description
earning - RewardPointsRate
How many points are earned for a given amount spent.
redemption - RewardPointsRate
How many points must be redeemed to get a given amount of currency discount at the checkout.

Example

{
  "earning": RewardPointsRate,
  "redemption": RewardPointsRate
}

RewardPointsRate

Contains details about customer's reward points rate.

Fields

Field Name
Description
currency_amount - Float!
The money value for the exchange rate. For earnings, this is the amount spent to earn the specified points. For redemption, this is the amount of money the number of points represents.
points - Float!
The number of points for an exchange rate. For earnings, this is the number of points earned. For redemption, this is the number of points needed for redemption.

Example

{"currency_amount": 987.65, "points": 987.65}

RewardPointsSubscriptionStatus

Indicates whether the customer subscribes to reward points emails.

Fields

Field Name
Description
balance_updates - RewardPointsSubscriptionStatusesEnum!
Indicates whether the customer subscribes to 'Reward points balance updates' emails.
points_expiration_notifications - RewardPointsSubscriptionStatusesEnum!
Indicates whether the customer subscribes to 'Reward points expiration notifications' emails.

Example

{
  "balance_updates": "SUBSCRIBED",
  "points_expiration_notifications": "SUBSCRIBED"
}

RewardPointsSubscriptionStatusesEnum

Values

Enum Value
Description
SUBSCRIBED
NOT_SUBSCRIBED

Example

""SUBSCRIBED""

RoutableInterface

Routable entities serve as the model for a rendered page.

Fields

Field Name
Description
redirect_code - Int!
Contains 0 when there is no redirect error. A value of 301 indicates the URL of the requested resource has been changed permanently, while a value of 302 indicates a temporary redirect.
relative_url - String
The internal relative URL. If the specified URL is a redirect, the query returns the redirected URL, not the original.
type - UrlRewriteEntityTypeEnum
One of PRODUCT, CATEGORY, or CMS_PAGE.

Possible Types

Example

{
  "redirect_code": 987,
  "relative_url": "xyz789",
  "type": "CMS_PAGE"
}

SalesCommentItem

Contains details about a comment.

Fields

Field Name
Description
message - String!
The text of the message.
timestamp - String!
The timestamp of the comment.

Example

{
  "message": "abc123",
  "timestamp": "abc123"
}

ScopeTypeEnum

This enumeration defines the scope type for customer orders.

Values

Enum Value
Description
GLOBAL
WEBSITE
STORE

Example

""GLOBAL""

SearchResultPageInfo

Provides navigation for the query response.

Fields

Field Name
Description
current_page - Int
The specific page to return.
page_size - Int
The maximum number of items to return per page of results.
total_pages - Int
The total number of pages in the response.

Example

{"current_page": 123, "page_size": 123, "total_pages": 123}

SearchSuggestion

A string that contains search suggestion

Fields

Field Name
Description
search - String!
The search suggestion of existing product.

Example

{"search": "abc123"}

SelectedBundleOption

Contains details about a selected bundle option.

Fields

Field Name
Description
id - Int!
(Deprecated: Use `uid` instead)
label - String!
The display name of the selected bundle product option.
type - String!
The type of selected bundle product option.
uid - ID!
The unique ID for a `SelectedBundleOption` object
values - [SelectedBundleOptionValue]!
An array of selected bundle option values.

Example

{
  "id": 987,
  "label": "xyz789",
  "type": "xyz789",
  "uid": 4,
  "values": [SelectedBundleOptionValue]
}

SelectedBundleOptionValue

Contains details about a value for a selected bundle option.

Fields

Field Name
Description
id - Int!
Use `uid` instead
label - String!
The display name of the value for the selected bundle product option.
price - Float!
The price of the value for the selected bundle product option.
quantity - Float!
The quantity of the value for the selected bundle product option.
uid - ID!
The unique ID for a `SelectedBundleOptionValue` object

Example

{
  "id": 987,
  "label": "abc123",
  "price": 123.45,
  "quantity": 123.45,
  "uid": 4
}

SelectedConfigurableOption

Contains details about a selected configurable option.

Fields

Field Name
Description
configurable_product_option_uid - ID!
The unique ID for a `ConfigurableProductOptions` object.
configurable_product_option_value_uid - ID!
The unique ID for a `ConfigurableProductOptionsValues` object.
id - Int!
(Deprecated: Use `SelectedConfigurableOption.configurable_product_option_uid` instead.)
option_label - String!
The display text for the option.
value_id - Int!
(Deprecated: Use `SelectedConfigurableOption.configurable_product_option_value_uid` instead.)
value_label - String!
The display name of the selected configurable option.

Example

{
  "configurable_product_option_uid": 4,
  "configurable_product_option_value_uid": 4,
  "id": 987,
  "option_label": "abc123",
  "value_id": 123,
  "value_label": "xyz789"
}

SelectedCustomAttributeInput

Contains details about an attribute the buyer selected.

Input Fields

Input Field
Description
attribute_code - String!
A string that identifies the selected attribute.
value - ID!
The unique ID for a `CustomAttribute` object of a selected custom attribute.

Example

{
  "attribute_code": "abc123",
  "value": "4"
}

SelectedCustomizableOption

Identifies a customized product that has been placed in a cart.

Fields

Field Name
Description
customizable_option_uid - ID!
The unique ID for a specific `CustomizableOptionInterface` object, such as a `CustomizableFieldOption`, `CustomizableFileOption`, or `CustomizableAreaOption` object.
id - Int!
(Deprecated: Use `SelectedCustomizableOption.customizable_option_uid` instead.)
is_required - Boolean!
Indicates whether the customizable option is required.
label - String!
The display name of the selected customizable option.
sort_order - Int!
A value indicating the order to display this option.
type - String!
The type of `CustomizableOptionInterface` object.
values - [SelectedCustomizableOptionValue]!
An array of selectable values.

Example

{
  "customizable_option_uid": "4",
  "id": 123,
  "is_required": true,
  "label": "abc123",
  "sort_order": 123,
  "type": "abc123",
  "values": [SelectedCustomizableOptionValue]
}

SelectedCustomizableOptionValue

Identifies the value of the selected customized option.

Fields

Field Name
Description
customizable_option_value_uid - ID!
The unique ID for a value object that corresponds to the object represented by the `customizable_option_uid` attribute.
id - Int!
(Deprecated: Use `SelectedCustomizableOptionValue.customizable_option_value_uid` instead.)
label - String!
The display name of the selected value.
price - CartItemSelectedOptionValuePrice!
The price of the selected customizable value.
value - String!
The text identifying the selected value.

Example

{
  "customizable_option_value_uid": 4,
  "id": 123,
  "label": "abc123",
  "price": CartItemSelectedOptionValuePrice,
  "value": "xyz789"
}

SelectedPaymentMethod

Describes the payment method the shopper selected.

Fields

Field Name
Description
code - String!
The payment method code.
purchase_order_number - String
The purchase order number.
title - String!
The payment method title.

Example

{
  "code": "xyz789",
  "purchase_order_number": "xyz789",
  "title": "xyz789"
}

SelectedShippingMethod

Contains details about the selected shipping method and carrier.

Fields

Field Name
Description
amount - Money!
The cost of shipping using this shipping method.
base_amount - Money
(Deprecated: The field should not be used on the storefront.)
carrier_code - String!
A string that identifies a commercial carrier or an offline shipping method.
carrier_title - String!
The label for the carrier code.
method_code - String!
A shipping method code associated with a carrier.
method_title - String!
The label for the method code.
price_excl_tax - Money!
The cost of shipping using this shipping method, excluding tax.
price_incl_tax - Money!
The cost of shipping using this shipping method, including tax.

Example

{
  "amount": Money,
  "base_amount": Money,
  "carrier_code": "abc123",
  "carrier_title": "xyz789",
  "method_code": "abc123",
  "method_title": "abc123",
  "price_excl_tax": Money,
  "price_incl_tax": Money
}

SendEmailToFriendInput

Defines the referenced product and the email sender and recipients.

Input Fields

Input Field
Description
product_id - Int!
The ID of the product that the sender is referencing.
recipients - [SendEmailToFriendRecipientInput]!
An array containing information about each recipient.
sender - SendEmailToFriendSenderInput!
Information about the customer and the content of the message.

Example

{
  "product_id": 987,
  "recipients": [SendEmailToFriendRecipientInput],
  "sender": SendEmailToFriendSenderInput
}

SendEmailToFriendOutput

Contains information about the sender and recipients.

Fields

Field Name
Description
recipients - [SendEmailToFriendRecipient]
An array containing information about each recipient.
sender - SendEmailToFriendSender
Information about the customer and the content of the message.

Example

{
  "recipients": [SendEmailToFriendRecipient],
  "sender": SendEmailToFriendSender
}

SendEmailToFriendRecipient

An output object that contains information about the recipient.

Fields

Field Name
Description
email - String!
The email address of the recipient.
name - String!
The name of the recipient.

Example

{
  "email": "abc123",
  "name": "abc123"
}

SendEmailToFriendRecipientInput

Contains details about a recipient.

Input Fields

Input Field
Description
email - String!
The email address of the recipient.
name - String!
The name of the recipient.

Example

{
  "email": "xyz789",
  "name": "abc123"
}

SendEmailToFriendSender

An output object that contains information about the sender.

Fields

Field Name
Description
email - String!
The email address of the sender.
message - String!
The text of the message to be sent.
name - String!
The name of the sender.

Example

{
  "email": "abc123",
  "message": "xyz789",
  "name": "xyz789"
}

SendEmailToFriendSenderInput

Contains details about the sender.

Input Fields

Input Field
Description
email - String!
The email address of the sender.
message - String!
The text of the message to be sent.
name - String!
The name of the sender.

Example

{
  "email": "abc123",
  "message": "xyz789",
  "name": "abc123"
}

SendFriendConfiguration

Contains details about the configuration of the Email to a Friend feature.

Fields

Field Name
Description
enabled_for_customers - Boolean!
Indicates whether the Email to a Friend feature is enabled.
enabled_for_guests - Boolean!
Indicates whether the Email to a Friend feature is enabled for guests.

Example

{"enabled_for_customers": false, "enabled_for_guests": true}

SendNegotiableQuoteForReviewInput

Specifies which negotiable quote to send for review.

Input Fields

Input Field
Description
comment - NegotiableQuoteCommentInput
A comment for the seller to review.
quote_uid - ID!
The unique ID of a `NegotiableQuote` object.

Example

{"comment": NegotiableQuoteCommentInput, "quote_uid": 4}

SendNegotiableQuoteForReviewOutput

Contains the negotiable quote.

Fields

Field Name
Description
quote - NegotiableQuote
The negotiable quote after sending for seller review.

Example

{"quote": NegotiableQuote}

SetBillingAddressOnCartInput

Sets the billing address.

Input Fields

Input Field
Description
billing_address - BillingAddressInput!
The billing address.
cart_id - String!
The unique ID of a `Cart` object.

Example

{
  "billing_address": BillingAddressInput,
  "cart_id": "abc123"
}

SetBillingAddressOnCartOutput

Contains details about the cart after setting the billing address.

Fields

Field Name
Description
cart - Cart!
The cart after setting the billing address.

Example

{"cart": Cart}

SetGiftOptionsOnCartInput

Defines the gift options applied to the cart.

Input Fields

Input Field
Description
cart_id - String!
The unique ID that identifies the shopper's cart.
gift_message - GiftMessageInput
Gift message details for the cart.
gift_receipt_included - Boolean!
Whether customer requested gift receipt for the cart.
gift_wrapping_id - ID
The unique ID for a `GiftWrapping` object to be used for the cart.
printed_card_included - Boolean!
Whether customer requested printed card for the cart.

Example

{
  "cart_id": "abc123",
  "gift_message": GiftMessageInput,
  "gift_receipt_included": true,
  "gift_wrapping_id": 4,
  "printed_card_included": false
}

SetGiftOptionsOnCartOutput

Contains the cart after gift options have been applied.

Fields

Field Name
Description
cart - Cart!
The modified cart object.

Example

{"cart": Cart}

SetGuestEmailOnCartInput

Defines the guest email and cart.

Input Fields

Input Field
Description
cart_id - String!
The unique ID of a `Cart` object.
email - String!
The email address of the guest.

Example

{
  "cart_id": "abc123",
  "email": "abc123"
}

SetGuestEmailOnCartOutput

Contains details about the cart after setting the email of a guest.

Fields

Field Name
Description
cart - Cart!
The cart after setting the guest email.

Example

{"cart": Cart}

SetNegotiableQuoteBillingAddressInput

Sets the billing address.

Input Fields

Input Field
Description
billing_address - NegotiableQuoteBillingAddressInput!
The billing address to be added.
quote_uid - ID!
The unique ID of a `NegotiableQuote` object.

Example

{
  "billing_address": NegotiableQuoteBillingAddressInput,
  "quote_uid": "4"
}

SetNegotiableQuoteBillingAddressOutput

Contains the negotiable quote.

Fields

Field Name
Description
quote - NegotiableQuote
The negotiable quote after assigning a billing address.

Example

{"quote": NegotiableQuote}

SetNegotiableQuotePaymentMethodInput

Defines the payment method of the specified negotiable quote.

Input Fields

Input Field
Description
payment_method - NegotiableQuotePaymentMethodInput!
The payment method to be assigned to the negotiable quote.
quote_uid - ID!
The unique ID of a `NegotiableQuote` object.

Example

{
  "payment_method": NegotiableQuotePaymentMethodInput,
  "quote_uid": 4
}

SetNegotiableQuotePaymentMethodOutput

Contains details about the negotiable quote after setting the payment method.

Fields

Field Name
Description
quote - NegotiableQuote
The updated negotiable quote.

Example

{"quote": NegotiableQuote}

SetNegotiableQuoteShippingAddressInput

Defines the shipping address to assign to the negotiable quote.

Input Fields

Input Field
Description
customer_address_id - ID
The unique ID of a `CustomerAddress` object.
quote_uid - ID!
The unique ID of a `NegotiableQuote` object.
shipping_addresses - [NegotiableQuoteShippingAddressInput]
An array of shipping addresses to apply to the negotiable quote.

Example

{
  "customer_address_id": "4",
  "quote_uid": 4,
  "shipping_addresses": [
    NegotiableQuoteShippingAddressInput
  ]
}

SetNegotiableQuoteShippingAddressOutput

Contains the negotiable quote.

Fields

Field Name
Description
quote - NegotiableQuote
The negotiable quote after assigning a shipping address.

Example

{"quote": NegotiableQuote}

SetNegotiableQuoteShippingMethodsInput

Defines the shipping method to apply to the negotiable quote.

Input Fields

Input Field
Description
quote_uid - ID!
The unique ID of a `NegotiableQuote` object.
shipping_methods - [ShippingMethodInput]!
An array of shipping methods to apply to the negotiable quote.

Example

{
  "quote_uid": "4",
  "shipping_methods": [ShippingMethodInput]
}

SetNegotiableQuoteShippingMethodsOutput

Contains the negotiable quote.

Fields

Field Name
Description
quote - NegotiableQuote
The negotiable quote after applying shipping methods.

Example

{"quote": NegotiableQuote}

SetPaymentMethodAndPlaceOrderInput

Applies a payment method to the quote.

Input Fields

Input Field
Description
cart_id - String!
The unique ID of a `Cart` object.
payment_method - PaymentMethodInput!
The payment method data to apply to the cart.

Example

{
  "cart_id": "abc123",
  "payment_method": PaymentMethodInput
}

SetPaymentMethodOnCartInput

Applies a payment method to the cart.

Input Fields

Input Field
Description
cart_id - String!
The unique ID of a `Cart` object.
payment_method - PaymentMethodInput!
The payment method data to apply to the cart.

Example

{
  "cart_id": "xyz789",
  "payment_method": PaymentMethodInput
}

SetPaymentMethodOnCartOutput

Contains details about the cart after setting the payment method.

Fields

Field Name
Description
cart - Cart!
The cart after setting the payment method.

Example

{"cart": Cart}

SetShippingAddressesOnCartInput

Specifies an array of addresses to use for shipping.

Input Fields

Input Field
Description
cart_id - String!
The unique ID of a `Cart` object.
shipping_addresses - [ShippingAddressInput]!
An array of shipping addresses.

Example

{
  "cart_id": "xyz789",
  "shipping_addresses": [ShippingAddressInput]
}

SetShippingAddressesOnCartOutput

Contains details about the cart after setting the shipping addresses.

Fields

Field Name
Description
cart - Cart!
The cart after setting the shipping addresses.

Example

{"cart": Cart}

SetShippingMethodsOnCartInput

Applies one or shipping methods to the cart.

Input Fields

Input Field
Description
cart_id - String!
The unique ID of a `Cart` object.
shipping_methods - [ShippingMethodInput]!
An array of shipping methods.

Example

{
  "cart_id": "abc123",
  "shipping_methods": [ShippingMethodInput]
}

SetShippingMethodsOnCartOutput

Contains details about the cart after setting the shipping methods.

Fields

Field Name
Description
cart - Cart!
The cart after setting the shipping methods.

Example

{"cart": Cart}

ShareGiftRegistryInviteeInput

Defines a gift registry invitee.

Input Fields

Input Field
Description
email - String!
The email address of the gift registry invitee.
name - String!
The name of the gift registry invitee.

Example

{
  "email": "xyz789",
  "name": "abc123"
}

ShareGiftRegistryOutput

Contains the results of a request to share a gift registry.

Fields

Field Name
Description
is_shared - Boolean!
Indicates whether the gift registry was successfully shared.

Example

{"is_shared": false}

ShareGiftRegistrySenderInput

Defines the sender of an invitation to view a gift registry.

Input Fields

Input Field
Description
message - String!
A brief message from the sender.
name - String!
The sender of the gift registry invitation.

Example

{
  "message": "abc123",
  "name": "xyz789"
}

ShipBundleItemsEnum

Defines whether bundle items must be shipped together.

Values

Enum Value
Description
TOGETHER
SEPARATELY

Example

""TOGETHER""

ShipmentItem

Fields

Field Name
Description
id - ID!
The unique ID for a `ShipmentItemInterface` object.
order_item - OrderItemInterface
The order item associated with the shipment item.
product_name - String
The name of the base product.
product_sale_price - Money!
The sale price for the base product.
product_sku - String!
The SKU of the base product.
quantity_shipped - Float!
The number of shipped items.

Example

{
  "id": "4",
  "order_item": OrderItemInterface,
  "product_name": "abc123",
  "product_sale_price": Money,
  "product_sku": "xyz789",
  "quantity_shipped": 987.65
}

ShipmentItemInterface

Order shipment item details.

Fields

Field Name
Description
id - ID!
The unique ID for a `ShipmentItemInterface` object.
order_item - OrderItemInterface
The order item associated with the shipment item.
product_name - String
The name of the base product.
product_sale_price - Money!
The sale price for the base product.
product_sku - String!
The SKU of the base product.
quantity_shipped - Float!
The number of shipped items.

Possible Types

Example

{
  "id": 4,
  "order_item": OrderItemInterface,
  "product_name": "abc123",
  "product_sale_price": Money,
  "product_sku": "abc123",
  "quantity_shipped": 987.65
}

ShipmentTracking

Contains order shipment tracking details.

Fields

Field Name
Description
carrier - String!
The shipping carrier for the order delivery.
number - String
The tracking number of the order shipment.
title - String!
The shipment tracking title.

Example

{
  "carrier": "abc123",
  "number": "abc123",
  "title": "xyz789"
}

ShippingAddressInput

Defines a single shipping address.

Input Fields

Input Field
Description
address - CartAddressInput
Defines a shipping address.
customer_address_id - Int
An ID from the customer's address book that uniquely identifies the address to be used for shipping.
customer_notes - String
Text provided by the shopper.
pickup_location_code - String
The code of Pickup Location which will be used for In-Store Pickup.

Example

{
  "address": CartAddressInput,
  "customer_address_id": 987,
  "customer_notes": "abc123",
  "pickup_location_code": "abc123"
}

ShippingCartAddress

Contains shipping addresses and methods.

Fields

Field Name
Description
available_shipping_methods - [AvailableShippingMethod]
An array that lists the shipping methods that can be applied to the cart.
cart_items - [CartItemQuantity]
(Deprecated: Use `cart_items_v2` instead.)
cart_items_v2 - [CartItemInterface]
An array that lists the items in the cart.
city - String!
The city specified for the billing or shipping address.
company - String
The company specified for the billing or shipping address.
country - CartAddressCountry!
An object containing the country label and code.
customer_notes - String
Text provided by the shopper.
firstname - String!
The first name of the customer or guest.
items_weight - Float
(Deprecated: This information should not be exposed on the frontend.)
lastname - String!
The last name of the customer or guest.
pickup_location_code - String
postcode - String
The ZIP or postal code of the billing or shipping address.
region - CartAddressRegion
An object containing the region label and code.
selected_shipping_method - SelectedShippingMethod
An object that describes the selected shipping method.
street - [String]!
An array containing the street for the billing or shipping address.
telephone - String
The telephone number for the billing or shipping address.
uid - String!
The unique id of the customer address.
vat_id - String
The VAT company number for billing or shipping address.

Example

{
  "available_shipping_methods": [AvailableShippingMethod],
  "cart_items": [CartItemQuantity],
  "cart_items_v2": [CartItemInterface],
  "city": "xyz789",
  "company": "abc123",
  "country": CartAddressCountry,
  "customer_notes": "xyz789",
  "firstname": "abc123",
  "items_weight": 123.45,
  "lastname": "abc123",
  "pickup_location_code": "abc123",
  "postcode": "xyz789",
  "region": CartAddressRegion,
  "selected_shipping_method": SelectedShippingMethod,
  "street": ["xyz789"],
  "telephone": "abc123",
  "uid": "abc123",
  "vat_id": "abc123"
}

ShippingDiscount

Defines an individual shipping discount. This discount can be applied to shipping.

Fields

Field Name
Description
amount - Money!
The amount of the discount.

Example

{"amount": Money}

ShippingHandling

Contains details about shipping and handling costs.

Fields

Field Name
Description
amount_excluding_tax - Money
The shipping amount, excluding tax.
amount_including_tax - Money
The shipping amount, including tax.
discounts - [ShippingDiscount]
The applied discounts to the shipping.
taxes - [TaxItem]
Details about taxes applied for shipping.
total_amount - Money!
The total amount for shipping.

Example

{
  "amount_excluding_tax": Money,
  "amount_including_tax": Money,
  "discounts": [ShippingDiscount],
  "taxes": [TaxItem],
  "total_amount": Money
}

ShippingMethodInput

Defines the shipping carrier and method.

Input Fields

Input Field
Description
carrier_code - String!
A string that identifies a commercial carrier or an offline delivery method.
method_code - String!
A string that indicates which service a commercial carrier will use to ship items. For offline delivery methods, this value is similar to the label displayed on the checkout page.

Example

{
  "carrier_code": "abc123",
  "method_code": "xyz789"
}

SimpleCartItem

An implementation for simple product cart items.

Fields

Field Name
Description
available_gift_wrapping - [GiftWrapping]!
The list of available gift wrapping options for the cart item.
customizable_options - [SelectedCustomizableOption]!
An array containing the customizable options the shopper selected.
errors - [CartItemError]
An array of errors encountered while loading the cart item
gift_message - GiftMessage
The entered gift message for the cart item
gift_wrapping - GiftWrapping
The selected gift wrapping for the cart item.
id - String!
(Deprecated: Use `uid` instead.)
prices - CartItemPrices
Contains details about the price of the item, including taxes and discounts.
product - ProductInterface!
Details about an item in the cart.
quantity - Float!
The quantity of this item in the cart.
uid - ID!
The unique ID for a `CartItemInterface` object.

Example

{
  "available_gift_wrapping": [GiftWrapping],
  "customizable_options": [SelectedCustomizableOption],
  "errors": [CartItemError],
  "gift_message": GiftMessage,
  "gift_wrapping": GiftWrapping,
  "id": "xyz789",
  "prices": CartItemPrices,
  "product": ProductInterface,
  "quantity": 123.45,
  "uid": 4
}

SimpleProduct

Defines a simple product, which is tangible and is usually sold in single units or in fixed quantities.

Fields

Field Name
Description
activity - String
(Deprecated: Use the `custom_attributes` field instead.)
attribute_set_id - Int
The attribute set assigned to the product. (Deprecated: The field should not be used on the storefront.)
canonical_url - String
The relative canonical URL. This value is returned only if the system setting 'Use Canonical Link Meta Tag For Products' is enabled.
categories - [CategoryInterface]
The categories assigned to a product.
category_gear - String
(Deprecated: Use the `custom_attributes` field instead.)
climate - String
(Deprecated: Use the `custom_attributes` field instead.)
collar - String
(Deprecated: Use the `custom_attributes` field instead.)
color - Int
(Deprecated: Use the `custom_attributes` field instead.)
country_of_manufacture - String
The product's country of origin.
created_at - String
Timestamp indicating when the product was created. (Deprecated: The field should not be used on the storefront.)
crosssell_products - [ProductInterface]
An array of cross-sell products.
description - ComplexTextValue
Detailed information about the product. The value can include simple HTML tags.
eco_collection - Int
(Deprecated: Use the `custom_attributes` field instead.)
erin_recommends - Int
(Deprecated: Use the `custom_attributes` field instead.)
features_bags - String
(Deprecated: Use the `custom_attributes` field instead.)
format - Int
(Deprecated: Use the `custom_attributes` field instead.)
gender - String
(Deprecated: Use the `custom_attributes` field instead.)
gift_message_available - String
Indicates whether a gift message is available.
id - Int
The ID number assigned to the product. (Deprecated: Use the `uid` field instead.)
image - ProductImage
The relative path to the main image on the product page.
is_returnable - String
Indicates whether the product can be returned.
manufacturer - Int
A number representing the product's manufacturer. (Deprecated: Use the `custom_attributes` field instead.)
material - String
(Deprecated: Use the `custom_attributes` field instead.)
media_gallery - [MediaGalleryInterface]
An array of media gallery objects.
media_gallery_entries - [MediaGalleryEntry]
An array of MediaGalleryEntry objects. (Deprecated: Use `media_gallery` instead.)
meta_description - String
A brief overview of the product for search results listings, maximum 255 characters.
meta_keyword - String
A comma-separated list of keywords that are visible only to search engines.
meta_title - String
A string that is displayed in the title bar and tab of the browser and in search results lists.
name - String
The product name. Customers use this name to identify the product.
new - Int
(Deprecated: Use the `custom_attributes` field instead.)
new_from_date - String
The beginning date for new product listings, and determines if the product is featured as a new product.
new_to_date - String
The end date for new product listings.
only_x_left_in_stock - Float
Product stock only x left count
options - [CustomizableOptionInterface]
An array of options for a customizable product.
options_container - String
If the product has multiple options, determines where they appear on the product page.
pattern - String
(Deprecated: Use the `custom_attributes` field instead.)
performance_fabric - Int
(Deprecated: Use the `custom_attributes` field instead.)
price - ProductPrices
Indicates the price of an item. (Deprecated: Use `price_range` for product price information.)
price_range - PriceRange!
The range of prices for the product
price_tiers - [TierPrice]
An array of `TierPrice` objects.
product_links - [ProductLinksInterface]
An array of `ProductLinks` objects.
purpose - Int
(Deprecated: Use the `custom_attributes` field instead.)
rating_summary - Float!
The average of all the ratings given to the product.
redirect_code - Int!
Contains 0 when there is no redirect error. A value of 301 indicates the URL of the requested resource has been changed permanently, while a value of 302 indicates a temporary redirect.
related_products - [ProductInterface]
An array of related products.
relative_url - String
The internal relative URL. If the specified URL is a redirect, the query returns the redirected URL, not the original.
review_count - Int!
The total count of all the reviews given to the product.
reviews - ProductReviews!
The list of products reviews.
sale - Int
(Deprecated: Use the `custom_attributes` field instead.)
short_description - ComplexTextValue
A short description of the product. Its use depends on the theme.
size - Int
(Deprecated: Use the `custom_attributes` field instead.)
sku - String
A number or code assigned to a product to identify the product, options, price, and manufacturer.
sleeve - String
(Deprecated: Use the `custom_attributes` field instead.)
small_image - ProductImage
The relative path to the small image, which is used on catalog pages.
special_from_date - String
The beginning date that a product has a special price. (Deprecated: The field should not be used on the storefront.)
special_price - Float
The discounted price of the product.
special_to_date - String
The end date for a product with a special price.
staged - Boolean!
Indicates whether the product is staged for a future campaign.
stock_status - ProductStockStatus
Stock status of the product
strap_bags - String
(Deprecated: Use the `custom_attributes` field instead.)
style_bags - String
(Deprecated: Use the `custom_attributes` field instead.)
style_bottom - String
(Deprecated: Use the `custom_attributes` field instead.)
style_general - String
(Deprecated: Use the `custom_attributes` field instead.)
swatch_image - String
The file name of a swatch image.
thumbnail - ProductImage
The relative path to the product's thumbnail image.
tier_price - Float
The price when tier pricing is in effect and the items purchased threshold has been reached. (Deprecated: Use `price_tiers` for product tier price information.)
tier_prices - [ProductTierPrices]
An array of ProductTierPrices objects. (Deprecated: Use `price_tiers` for product tier price information.)
type - UrlRewriteEntityTypeEnum
One of PRODUCT, CATEGORY, or CMS_PAGE.
type_id - String
One of simple, virtual, bundle, downloadable, grouped, or configurable. (Deprecated: Use `__typename` instead.)
uid - ID!
The unique ID for a `ProductInterface` object.
updated_at - String
Timestamp indicating when the product was updated. (Deprecated: The field should not be used on the storefront.)
upsell_products - [ProductInterface]
An array of up-sell products.
url_key - String
The part of the URL that identifies the product
url_path - String
(Deprecated: Use product's `canonical_url` or url rewrites instead)
url_rewrites - [UrlRewrite]
URL rewrites list
url_suffix - String
The part of the product URL that is appended after the url key
websites - [Website]
An array of websites in which the product is available. (Deprecated: The field should not be used on the storefront.)
weight - Float
The weight of the item, in units defined by the store.

Example

{
  "activity": "abc123",
  "attribute_set_id": 987,
  "canonical_url": "xyz789",
  "categories": [CategoryInterface],
  "category_gear": "xyz789",
  "climate": "abc123",
  "collar": "xyz789",
  "color": 123,
  "country_of_manufacture": "xyz789",
  "created_at": "xyz789",
  "crosssell_products": [ProductInterface],
  "description": ComplexTextValue,
  "eco_collection": 123,
  "erin_recommends": 987,
  "features_bags": "abc123",
  "format": 987,
  "gender": "abc123",
  "gift_message_available": "xyz789",
  "id": 987,
  "image": ProductImage,
  "is_returnable": "abc123",
  "manufacturer": 123,
  "material": "xyz789",
  "media_gallery": [MediaGalleryInterface],
  "media_gallery_entries": [MediaGalleryEntry],
  "meta_description": "xyz789",
  "meta_keyword": "xyz789",
  "meta_title": "xyz789",
  "name": "abc123",
  "new": 123,
  "new_from_date": "abc123",
  "new_to_date": "abc123",
  "only_x_left_in_stock": 987.65,
  "options": [CustomizableOptionInterface],
  "options_container": "abc123",
  "pattern": "abc123",
  "performance_fabric": 987,
  "price": ProductPrices,
  "price_range": PriceRange,
  "price_tiers": [TierPrice],
  "product_links": [ProductLinksInterface],
  "purpose": 123,
  "rating_summary": 987.65,
  "redirect_code": 987,
  "related_products": [ProductInterface],
  "relative_url": "xyz789",
  "review_count": 987,
  "reviews": ProductReviews,
  "sale": 123,
  "short_description": ComplexTextValue,
  "size": 987,
  "sku": "abc123",
  "sleeve": "abc123",
  "small_image": ProductImage,
  "special_from_date": "xyz789",
  "special_price": 123.45,
  "special_to_date": "abc123",
  "staged": false,
  "stock_status": "IN_STOCK",
  "strap_bags": "abc123",
  "style_bags": "abc123",
  "style_bottom": "abc123",
  "style_general": "xyz789",
  "swatch_image": "abc123",
  "thumbnail": ProductImage,
  "tier_price": 987.65,
  "tier_prices": [ProductTierPrices],
  "type": "CMS_PAGE",
  "type_id": "abc123",
  "uid": "4",
  "updated_at": "xyz789",
  "upsell_products": [ProductInterface],
  "url_key": "xyz789",
  "url_path": "abc123",
  "url_rewrites": [UrlRewrite],
  "url_suffix": "abc123",
  "websites": [Website],
  "weight": 987.65
}

SimpleProductCartItemInput

Defines a single product to add to the cart.

Input Fields

Input Field
Description
customizable_options - [CustomizableOptionInput]
An array that defines customizable options for the product.
data - CartItemInput!
An object containing the `sku`, `quantity`, and other relevant information about the product.

Example

{
  "customizable_options": [CustomizableOptionInput],
  "data": CartItemInput
}

SimpleRequisitionListItem

Contains details about simple products added to a requisition list.

Fields

Field Name
Description
customizable_options - [SelectedCustomizableOption]!
Selected custom options for an item in the requisition list.
product - ProductInterface!
Details about a requisition list item.
quantity - Float!
The amount added.
uid - ID!
The unique ID for the requisition list item.

Example

{
  "customizable_options": [SelectedCustomizableOption],
  "product": ProductInterface,
  "quantity": 123.45,
  "uid": 4
}

SimpleWishlistItem

Contains a simple product wish list item.

Fields

Field Name
Description
added_at - String!
The date and time the item was added to the wish list.
customizable_options - [SelectedCustomizableOption]!
Custom options selected for the wish list item.
description - String
The description of the item.
id - ID!
The unique ID for a `WishlistItemInterface` object.
product - ProductInterface
Product details of the wish list item.
quantity - Float!
The quantity of this wish list item.

Example

{
  "added_at": "xyz789",
  "customizable_options": [SelectedCustomizableOption],
  "description": "xyz789",
  "id": 4,
  "product": ProductInterface,
  "quantity": 987.65
}

SortEnum

Indicates whether to return results in ascending or descending order.

Values

Enum Value
Description
ASC
DESC

Example

""ASC""

SortField

Defines a possible sort field.

Fields

Field Name
Description
label - String
The label of the sort field.
value - String
The attribute code of the sort field.

Example

{
  "label": "xyz789",
  "value": "abc123"
}

SortFields

Contains a default value for sort fields and all available sort fields.

Fields

Field Name
Description
default - String
The default sort field value.
options - [SortField]
An array of possible sort fields.

Example

{
  "default": "abc123",
  "options": [SortField]
}

StoreConfig

Contains information about a store's configuration.

Fields

Field Name
Description
absolute_footer - String
Contains scripts that must be included in the HTML before the closing `<body>` tag.
allow_gift_receipt - String
Indicates if the gift sender has the option to send a gift receipt. Possible values: 1 (Yes) and 0 (No).
allow_gift_wrapping_on_order - String
Indicates whether gift wrapping can be added for the entire order. Possible values: 1 (Yes) and 0 (No).
allow_gift_wrapping_on_order_items - String
Indicates whether gift wrapping can be added for individual order items. Possible values: 1 (Yes) and 0 (No).
allow_guests_to_write_product_reviews - String
Indicates whether guest users can write product reviews. Possible values: 1 (Yes) and 0 (No).
allow_items - String
The value of the Allow Gift Messages for Order Items option
allow_order - String
The value of the Allow Gift Messages on Order Level option
allow_printed_card - String
Indicates if a printed card can accompany an order. Possible values: 1 (Yes) and 0 (No).
autocomplete_on_storefront - Boolean
Indicates whether to enable autocomplete on login and forgot password forms.
base_currency_code - String
The base currency code.
base_link_url - String
A fully-qualified URL that is used to create relative links to the `base_url`.
base_media_url - String
The fully-qualified URL that specifies the location of media files.
base_static_url - String
The fully-qualified URL that specifies the location of static view files.
base_url - String
The store’s fully-qualified base URL.
braintree_cc_vault_active - String
Braintree cc vault status.
cart_gift_wrapping - String
Indicates if gift wrapping prices are displayed on the Shopping Cart page. Possible values: 1 (Yes) and 0 (No).
cart_printed_card - String
Indicates if printed card prices are displayed on the Shopping Cart page. Possible values: 1 (Yes) and 0 (No).
catalog_default_sort_by - String
The default sort order of the search results list.
category_fixed_product_tax_display_setting - FixedProductTaxDisplaySettings
Corresponds to the 'Display Prices In Product Lists' field in the Admin. It indicates how FPT information is displayed on category pages.
category_url_suffix - String
The suffix applied to category pages, such as `.htm` or `.html`.
check_money_order_enable_for_specific_countries - Boolean
Indicates whether only specific countries can use this payment method.
check_money_order_enabled - Boolean
Indicates whether the Check/Money Order payment method is enabled.
check_money_order_make_check_payable_to - String
The name of the party to whom the check must be payable.
check_money_order_max_order_total - String
The maximum order amount required to qualify for the Check/Money Order payment method.
check_money_order_min_order_total - String
The minimum order amount required to qualify for the Check/Money Order payment method.
check_money_order_new_order_status - String
The status of new orders placed using the Check/Money Order payment method.
check_money_order_payment_from_specific_countries - String
A comma-separated list of specific countries allowed to use the Check/Money Order payment method.
check_money_order_send_check_to - String
The full street address or PO Box where the checks are mailed.
check_money_order_sort_order - Int
A number indicating the position of the Check/Money Order payment method in the list of available payment methods during checkout.
check_money_order_title - String
The title of the Check/Money Order payment method displayed on the storefront.
cms_home_page - String
The name of the CMS page that identifies the home page for the store.
cms_no_cookies - String
A specific CMS page that displays when cookies are not enabled for the browser.
cms_no_route - String
A specific CMS page that displays when a 404 'Page Not Found' error occurs.
code - String
A code assigned to the store to identify it. (Deprecated: Use `store_code` instead.)
configurable_thumbnail_source - String
Indicates whether the `parent` or child (`itself`) thumbnail should be used in the cart for configurable products.
copyright - String
The copyright statement that appears at the bottom of each page.
default_description - String
The description that provides a summary of your site for search engine listings. It should not be more than 160 characters in length.
default_display_currency_code - String
The default display currency code.
default_keywords - String
A series of keywords that describe your store, each separated by a comma.
default_title - String
The title that appears at the title bar of each page when viewed in a browser.
demonotice - Int
Controls the display of the demo store notice at the top of the page. Options: 0 (No) or 1 (Yes).
enable_multiple_wishlists - String
Indicates whether customers can have multiple wish lists. Possible values: 1 (Yes) and 0 (No).
front - String
The landing page that is associated with the base URL.
grid_per_page - Int
The default number of products per page in Grid View.
grid_per_page_values - String
A list of numbers that define how many products can be displayed in Grid View.
head_includes - String
Scripts that must be included in the HTML before the closing `<head>` tag.
head_shortcut_icon - String
The small graphic image (favicon) that appears in the address bar and tab of the browser.
header_logo_src - String
The path to the logo that appears in the header.
id - Int
The ID number assigned to the store. (Deprecated: Use `store_code` instead.)
is_default_store - Boolean
Indicates whether the store view has been designated as the default within the store group.
is_default_store_group - Boolean
Indicates whether the store group has been designated as the default within the website.
is_negotiable_quote_active - Boolean
Indicates whether negotiable quote functionality is enabled.
is_requisition_list_active - String
Indicates whether requisition lists are enabled. Possible values: 1 (Yes) and 0 (No).
list_mode - String
The format of the search results list.
list_per_page - Int
The default number of products per page in List View.
list_per_page_values - String
A list of numbers that define how many products can be displayed in List View.
locale - String
The store locale.
logo_alt - String
The Alt text that is associated with the logo.
logo_height - Int
The height of the logo image, in pixels.
logo_width - Int
The width of the logo image, in pixels.
magento_reward_general_is_enabled - String
Indicates whether reward points functionality is enabled. Possible values: 1 (Enabled) and 0 (Disabled).
magento_reward_general_is_enabled_on_front - String
Indicates whether reward points functionality is enabled on the storefront. Possible values: 1 (Enabled) and 0 (Disabled).
magento_reward_general_min_points_balance - String
The minimum point balance customers must have before they can redeem them. A null value indicates no minimum.
magento_reward_general_publish_history - String
When enabled, customers can see a detailed history of their reward points. Possible values: 1 (Enabled) and 0 (Disabled).
magento_reward_points_invitation_customer - String
The number of points for a referral when an invitee registers on the site.
magento_reward_points_invitation_customer_limit - String
The maximum number of registration referrals that will qualify for rewards. A null value indicates no limit.
magento_reward_points_invitation_order - String
The number of points for a referral, when an invitee places their first order on the site.
magento_reward_points_invitation_order_limit - String
The number of order conversions that can earn points for the customer who sends the invitation. A null value indicates no limit.
magento_reward_points_newsletter - String
The number of points earned by registered customers who subscribe to a newsletter.
magento_reward_points_order - String
Indicates customers earn points for shopping according to the reward point exchange rate. In Luma, this also controls whether to show a message in the shopping cart about the rewards points earned for the purchase, as well as the customer’s current reward point balance.
magento_reward_points_register - String
The number of points customer gets for registering.
magento_reward_points_review - String
The number of points for writing a review.
magento_reward_points_review_limit - String
The maximum number of reviews that will qualify for the rewards. A null value indicates no limit.
magento_wishlist_general_is_enabled - String
Indicates whether wishlists are enabled (1) or disabled (0).
maximum_number_of_wishlists - String
If multiple wish lists are enabled, the maximum number of wish lists the customer can have.
minimum_password_length - String
The minimum number of characters required for a valid password.
no_route - String
The default page that displays when a 404 'Page not Found' error occurs.
payment_payflowpro_cc_vault_active - String
Payflow Pro vault status.
printed_card_price - String
The default price of a printed card that accompanies an order.
product_fixed_product_tax_display_setting - FixedProductTaxDisplaySettings
Corresponds to the 'Display Prices On Product View Page' field in the Admin. It indicates how FPT information is displayed on product pages.
product_reviews_enabled - String
Indicates whether product reviews are enabled. Possible values: 1 (Yes) and 0 (No).
product_url_suffix - String
The suffix applied to product pages, such as `.htm` or `.html`.
required_character_classes_number - String
The number of different character classes (lowercase, uppercase, digits, special characters) required in a password.
returns_enabled - String!
Indicates whether RMA is enabled on the storefront. Possible values: enabled/disabled.
root_category_id - Int
The ID of the root category. (Deprecated: Use `root_category_uid` instead.)
root_category_uid - ID
The unique ID for a `CategoryInterface` object.
sales_fixed_product_tax_display_setting - FixedProductTaxDisplaySettings
Corresponds to the 'Display Prices In Sales Modules' field in the Admin. It indicates how FPT information is displayed on cart, checkout, and order pages.
sales_gift_wrapping - String
Indicates if gift wrapping prices are displayed on the Orders page. Possible values: 1 (Yes) and 0 (No).
sales_printed_card - String
Indicates if printed card prices are displayed on the Orders page. Possible values: 1 (Yes) and 0 (No).
secure_base_link_url - String
A secure fully-qualified URL that is used to create relative links to the `base_url`.
secure_base_media_url - String
The secure fully-qualified URL that specifies the location of media files.
secure_base_static_url - String
The secure fully-qualified URL that specifies the location of static view files.
secure_base_url - String
The store’s fully-qualified secure base URL.
send_friend - SendFriendConfiguration
Email to a Friend configuration.
show_cms_breadcrumbs - Int
Indicates whether a breadcrumb trail appears on all CMS pages in the catalog. 0 (No) or 1 (Yes).
store_code - ID
The unique ID of the store view. In the Admin, this is called the Store View Code. When making a GraphQL call, assign this value to the `Store` header to provide the scope.
store_group_code - ID
The unique ID assigned to the store group. In the Admin, this is called the Store Name.
store_group_name - String
The label assigned to the store group.
store_name - String
The label assigned to the store view.
store_sort_order - Int
The store view sort order.
timezone - String
The time zone of the store.
title_prefix - String
A prefix that appears before the title to create a two- or three-part title.
title_separator - String
The character that separates the category name and subcategory in the browser title bar.
title_suffix - String
A suffix that appears after the title to create a two- or three-part title.
use_store_in_url - Boolean
Indicates whether the store code should be used in the URL.
website_code - ID
The unique ID for the website.
website_id - Int
The ID number assigned to the website store. (Deprecated: The field should not be used on the storefront.)
website_name - String
The label assigned to the website.
weight_unit - String
The unit of weight.
welcome - String
Text that appears in the header of the page and includes the name of the logged in customer.
zero_subtotal_enable_for_specific_countries - Boolean
Indicates whether only specific countries can use this payment method.
zero_subtotal_enabled - Boolean
Indicates whether the Zero Subtotal payment method is enabled.
zero_subtotal_new_order_status - String
The status of new orders placed using the Zero Subtotal payment method.
zero_subtotal_payment_action - String
When the new order status is 'Processing', this can be set to `authorize_capture` to automatically invoice all items that have a zero balance.
zero_subtotal_payment_from_specific_countries - String
A comma-separated list of specific countries allowed to use the Zero Subtotal payment method.
zero_subtotal_sort_order - Int
A number indicating the position of the Zero Subtotal payment method in the list of available payment methods during checkout.
zero_subtotal_title - String
The title of the Zero Subtotal payment method displayed on the storefront.

Example

{
  "absolute_footer": "abc123",
  "allow_gift_receipt": "abc123",
  "allow_gift_wrapping_on_order": "abc123",
  "allow_gift_wrapping_on_order_items": "abc123",
  "allow_guests_to_write_product_reviews": "abc123",
  "allow_items": "xyz789",
  "allow_order": "abc123",
  "allow_printed_card": "xyz789",
  "autocomplete_on_storefront": true,
  "base_currency_code": "xyz789",
  "base_link_url": "xyz789",
  "base_media_url": "abc123",
  "base_static_url": "abc123",
  "base_url": "abc123",
  "braintree_cc_vault_active": "abc123",
  "cart_gift_wrapping": "abc123",
  "cart_printed_card": "abc123",
  "catalog_default_sort_by": "abc123",
  "category_fixed_product_tax_display_setting": "INCLUDE_FPT_WITHOUT_DETAILS",
  "category_url_suffix": "abc123",
  "check_money_order_enable_for_specific_countries": true,
  "check_money_order_enabled": false,
  "check_money_order_make_check_payable_to": "xyz789",
  "check_money_order_max_order_total": "xyz789",
  "check_money_order_min_order_total": "xyz789",
  "check_money_order_new_order_status": "xyz789",
  "check_money_order_payment_from_specific_countries": "abc123",
  "check_money_order_send_check_to": "abc123",
  "check_money_order_sort_order": 987,
  "check_money_order_title": "abc123",
  "cms_home_page": "xyz789",
  "cms_no_cookies": "xyz789",
  "cms_no_route": "abc123",
  "code": "xyz789",
  "configurable_thumbnail_source": "xyz789",
  "copyright": "abc123",
  "default_description": "abc123",
  "default_display_currency_code": "xyz789",
  "default_keywords": "abc123",
  "default_title": "xyz789",
  "demonotice": 123,
  "enable_multiple_wishlists": "abc123",
  "front": "abc123",
  "grid_per_page": 987,
  "grid_per_page_values": "xyz789",
  "head_includes": "abc123",
  "head_shortcut_icon": "abc123",
  "header_logo_src": "abc123",
  "id": 123,
  "is_default_store": false,
  "is_default_store_group": false,
  "is_negotiable_quote_active": false,
  "is_requisition_list_active": "xyz789",
  "list_mode": "abc123",
  "list_per_page": 123,
  "list_per_page_values": "abc123",
  "locale": "xyz789",
  "logo_alt": "abc123",
  "logo_height": 987,
  "logo_width": 123,
  "magento_reward_general_is_enabled": "xyz789",
  "magento_reward_general_is_enabled_on_front": "xyz789",
  "magento_reward_general_min_points_balance": "abc123",
  "magento_reward_general_publish_history": "xyz789",
  "magento_reward_points_invitation_customer": "xyz789",
  "magento_reward_points_invitation_customer_limit": "xyz789",
  "magento_reward_points_invitation_order": "xyz789",
  "magento_reward_points_invitation_order_limit": "abc123",
  "magento_reward_points_newsletter": "xyz789",
  "magento_reward_points_order": "xyz789",
  "magento_reward_points_register": "abc123",
  "magento_reward_points_review": "xyz789",
  "magento_reward_points_review_limit": "xyz789",
  "magento_wishlist_general_is_enabled": "abc123",
  "maximum_number_of_wishlists": "xyz789",
  "minimum_password_length": "abc123",
  "no_route": "xyz789",
  "payment_payflowpro_cc_vault_active": "xyz789",
  "printed_card_price": "abc123",
  "product_fixed_product_tax_display_setting": "INCLUDE_FPT_WITHOUT_DETAILS",
  "product_reviews_enabled": "xyz789",
  "product_url_suffix": "xyz789",
  "required_character_classes_number": "abc123",
  "returns_enabled": "xyz789",
  "root_category_id": 987,
  "root_category_uid": "4",
  "sales_fixed_product_tax_display_setting": "INCLUDE_FPT_WITHOUT_DETAILS",
  "sales_gift_wrapping": "xyz789",
  "sales_printed_card": "abc123",
  "secure_base_link_url": "abc123",
  "secure_base_media_url": "xyz789",
  "secure_base_static_url": "abc123",
  "secure_base_url": "abc123",
  "send_friend": SendFriendConfiguration,
  "show_cms_breadcrumbs": 123,
  "store_code": 4,
  "store_group_code": 4,
  "store_group_name": "abc123",
  "store_name": "abc123",
  "store_sort_order": 123,
  "timezone": "xyz789",
  "title_prefix": "xyz789",
  "title_separator": "abc123",
  "title_suffix": "abc123",
  "use_store_in_url": true,
  "website_code": "4",
  "website_id": 987,
  "website_name": "xyz789",
  "weight_unit": "abc123",
  "welcome": "abc123",
  "zero_subtotal_enable_for_specific_countries": false,
  "zero_subtotal_enabled": true,
  "zero_subtotal_new_order_status": "xyz789",
  "zero_subtotal_payment_action": "xyz789",
  "zero_subtotal_payment_from_specific_countries": "xyz789",
  "zero_subtotal_sort_order": 987,
  "zero_subtotal_title": "abc123"
}

StorefrontProperties

Indicates where an attribute can be displayed.

Fields

Field Name
Description
position - Int
The relative position of the attribute in the layered navigation block.
use_in_layered_navigation - UseInLayeredNavigationOptions
Indicates whether the attribute is filterable with results, without results, or not at all.
use_in_product_listing - Boolean
Indicates whether the attribute is displayed in product listings.
use_in_search_results_layered_navigation - Boolean
Indicates whether the attribute can be used in layered navigation on search results pages.
visible_on_catalog_pages - Boolean
Indicates whether the attribute is displayed on product pages.

Example

{
  "position": 123,
  "use_in_layered_navigation": "NO",
  "use_in_product_listing": true,
  "use_in_search_results_layered_navigation": false,
  "visible_on_catalog_pages": false
}

String

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"

SubscribeEmailToNewsletterOutput

Contains the result of the subscribeEmailToNewsletter operation.

Fields

Field Name
Description
status - SubscriptionStatusesEnum
The status of the subscription request.

Example

{"status": "NOT_ACTIVE"}

SubscriptionStatusesEnum

Indicates the status of the request.

Values

Enum Value
Description
NOT_ACTIVE
SUBSCRIBED
UNSUBSCRIBED
UNCONFIRMED

Example

""NOT_ACTIVE""

SwatchData

Describes the swatch type and a value.

Fields

Field Name
Description
type - String
The type of swatch filter item: 1 - text; 2 - image.
value - String
The value for the swatch item. It could be text or an image link.

Example

{
  "type": "xyz789",
  "value": "xyz789"
}

SwatchDataInterface

Fields

Field Name
Description
value - String
The value can be represented as color (HEX code), image link, or text.

Possible Types

SwatchDataInterface Types
ImageSwatchData
TextSwatchData
ColorSwatchData

Example

{"value": "abc123"}

SwatchLayerFilterItem

Fields

Field Name
Description
items_count - Int
The count of items per filter. (Deprecated: Use `AggregationOption.count` instead.)
label - String
The label for a filter. (Deprecated: Use `AggregationOption.label` instead.)
swatch_data - SwatchData
Data required to render a swatch filter item.
value_string - String
The value of a filter request variable to be used in query. (Deprecated: Use `AggregationOption.value` instead.)

Example

{
  "items_count": 123,
  "label": "abc123",
  "swatch_data": SwatchData,
  "value_string": "xyz789"
}

SwatchLayerFilterItemInterface

Fields

Field Name
Description
swatch_data - SwatchData
Data required to render a swatch filter item.

Possible Types

SwatchLayerFilterItemInterface Types
SwatchLayerFilterItem

Example

{"swatch_data": SwatchData}

TaxItem

Contains tax item details.

Fields

Field Name
Description
amount - Money!
The amount of tax applied to the item.
rate - Float!
The rate used to calculate the tax.
title - String!
A title that describes the tax.

Example

{
  "amount": Money,
  "rate": 123.45,
  "title": "xyz789"
}

TextSwatchData

Fields

Field Name
Description
value - String
The value can be represented as color (HEX code), image link, or text.

Example

{"value": "xyz789"}

TierPrice

Defines a price based on the quantity purchased.

Fields

Field Name
Description
discount - ProductDiscount
The price discount that this tier represents.
final_price - Money
The price of the product at this tier.
quantity - Float
The minimum number of items that must be purchased to qualify for this price tier.

Example

{
  "discount": ProductDiscount,
  "final_price": Money,
  "quantity": 123.45
}

UpdateCartItemsInput

Modifies the specified items in the cart.

Input Fields

Input Field
Description
cart_id - String!
The unique ID of a `Cart` object.
cart_items - [CartItemUpdateInput]!
An array of items to be updated.

Example

{
  "cart_id": "abc123",
  "cart_items": [CartItemUpdateInput]
}

UpdateCartItemsOutput

Contains details about the cart after updating items.

Fields

Field Name
Description
cart - Cart!
The cart after updating products.

Example

{"cart": Cart}

UpdateCompanyOutput

Contains the response to the request to update the company.

Fields

Field Name
Description
company - Company!
The updated company instance.

Example

{"company": Company}

UpdateCompanyRoleOutput

Contains the response to the request to update the company role.

Fields

Field Name
Description
role - CompanyRole!
The updated company role instance.

Example

{"role": CompanyRole}

UpdateCompanyStructureOutput

Contains the response to the request to update the company structure.

Fields

Field Name
Description
company - Company!
The updated company instance.

Example

{"company": Company}

UpdateCompanyTeamOutput

Contains the response to the request to update a company team.

Fields

Field Name
Description
team - CompanyTeam!
The updated company team instance.

Example

{"team": CompanyTeam}

UpdateCompanyUserOutput

Contains the response to the request to update the company user.

Fields

Field Name
Description
user - Customer!
The updated company user instance.

Example

{"user": Customer}

UpdateGiftRegistryInput

Defines updates to a GiftRegistry object.

Input Fields

Input Field
Description
dynamic_attributes - [GiftRegistryDynamicAttributeInput]
Additional attributes specified as a code-value pair. Unspecified dynamic attributes are not changed.
event_name - String
The updated name of the event.
message - String
The updated message describing the event.
privacy_settings - GiftRegistryPrivacySettings
Indicates whether the gift registry is PRIVATE or PUBLIC.
shipping_address - GiftRegistryShippingAddressInput
The updated shipping address for all gift registry items.
status - GiftRegistryStatus
Indicates whether the gift registry is ACTIVE or INACTIVE.

Example

{
  "dynamic_attributes": [
    GiftRegistryDynamicAttributeInput
  ],
  "event_name": "abc123",
  "message": "abc123",
  "privacy_settings": "PRIVATE",
  "shipping_address": GiftRegistryShippingAddressInput,
  "status": "ACTIVE"
}

UpdateGiftRegistryItemInput

Defines updates to an item in a gift registry.

Input Fields

Input Field
Description
gift_registry_item_uid - ID!
The unique ID of a `giftRegistryItem` object.
note - String
The updated description of the item.
quantity - Float!
The updated quantity of the gift registry item.

Example

{
  "gift_registry_item_uid": 4,
  "note": "abc123",
  "quantity": 123.45
}

UpdateGiftRegistryItemsOutput

Contains the results of a request to update gift registry items.

Fields

Field Name
Description
gift_registry - GiftRegistry
The gift registry after updating updating items.

Example

{"gift_registry": GiftRegistry}

UpdateGiftRegistryOutput

Contains the results of a request to update a gift registry.

Fields

Field Name
Description
gift_registry - GiftRegistry
The updated gift registry.

Example

{"gift_registry": GiftRegistry}

UpdateGiftRegistryRegistrantInput

Defines updates to an existing registrant.

Input Fields

Input Field
Description
dynamic_attributes - [GiftRegistryDynamicAttributeInput]
As a result of the update, only the values of provided attributes will be affected. If the attribute is missing in the request, its value will not be changed.
email - String
The updated email address of the registrant.
firstname - String
The updated first name of the registrant.
gift_registry_registrant_uid - ID!
The unique ID of a `giftRegistryRegistrant` object.
lastname - String
The updated last name of the registrant.

Example

{
  "dynamic_attributes": [
    GiftRegistryDynamicAttributeInput
  ],
  "email": "abc123",
  "firstname": "abc123",
  "gift_registry_registrant_uid": 4,
  "lastname": "xyz789"
}

UpdateGiftRegistryRegistrantsOutput

Contains the results a request to update registrants.

Fields

Field Name
Description
gift_registry - GiftRegistry
The gift registry after updating registrants.

Example

{"gift_registry": GiftRegistry}

UpdateNegotiableQuoteItemsQuantityOutput

Contains the updated negotiable quote.

Fields

Field Name
Description
quote - NegotiableQuote
The updated negotiable quote.

Example

{"quote": NegotiableQuote}

UpdateNegotiableQuoteQuantitiesInput

Specifies the items to update.

Input Fields

Input Field
Description
items - [NegotiableQuoteItemQuantityInput]!
An array of items to update.
quote_uid - ID!
The unique ID of a `NegotiableQuote` object.

Example

{
  "items": [NegotiableQuoteItemQuantityInput],
  "quote_uid": 4
}

UpdateProductsInWishlistOutput

Contains the customer's wish list and any errors encountered.

Fields

Field Name
Description
user_errors - [WishListUserInputError]!
An array of errors encountered while updating products in a wish list.
wishlist - Wishlist!
Contains the wish list with all items that were successfully updated.

Example

{
  "user_errors": [WishListUserInputError],
  "wishlist": Wishlist
}

UpdatePurchaseOrderApprovalRuleInput

Defines the changes to be made to an approval rule.

Input Fields

Input Field
Description
applies_to - [ID]
An updated list of company user role IDs to which this purchase order approval rule should be applied. When an empty array is provided, the rule is applied to all user roles in the system, including those created in the future.
approvers - [ID]
An updated list of B2B user roles that can approve this purchase order approval rule.
condition - CreatePurchaseOrderApprovalRuleConditionInput
The updated condition of the purchase order approval rule.
description - String
The updated approval rule description.
name - String
The updated approval rule name.
status - PurchaseOrderApprovalRuleStatus
The updated status of the purchase order approval rule.
uid - ID!
Unique identifier for the purchase order approval rule.

Example

{
  "applies_to": ["4"],
  "approvers": [4],
  "condition": CreatePurchaseOrderApprovalRuleConditionInput,
  "description": "xyz789",
  "name": "abc123",
  "status": "ENABLED",
  "uid": "4"
}

UpdateRequisitionListInput

An input object that defines which requistion list characteristics to update.

Input Fields

Input Field
Description
description - String
The updated description of the requisition list.
name - String!
The new name of the requisition list.

Example

{
  "description": "abc123",
  "name": "xyz789"
}

UpdateRequisitionListItemsInput

Defines which items in a requisition list to update.

Input Fields

Input Field
Description
entered_options - [EnteredOptionInput]
An array of customer-entered options.
item_id - ID!
The ID of the requisition list item to update.
quantity - Float
The new quantity of the item.
selected_options - [String]
An array of selected option IDs.

Example

{
  "entered_options": [EnteredOptionInput],
  "item_id": 4,
  "quantity": 123.45,
  "selected_options": ["xyz789"]
}

UpdateRequisitionListItemsOutput

Output of the request to update items in the specified requisition list.

Fields

Field Name
Description
requisition_list - RequisitionList
The requisition list after updating items.

Example

{"requisition_list": RequisitionList}

UpdateRequisitionListOutput

Output of the request to rename the requisition list.

Fields

Field Name
Description
requisition_list - RequisitionList
The renamed requisition list.

Example

{"requisition_list": RequisitionList}

UpdateWishlistOutput

Contains the name and visibility of an updated wish list.

Fields

Field Name
Description
name - String!
The wish list name.
uid - ID!
The unique ID of a `Wishlist` object.
visibility - WishlistVisibilityEnum!
Indicates whether the wish list is public or private.

Example

{
  "name": "abc123",
  "uid": 4,
  "visibility": "PUBLIC"
}

UrlRewrite

Contains URL rewrite details.

Fields

Field Name
Description
parameters - [HttpQueryParameter]
An array of request parameters.
url - String
The request URL.

Example

{
  "parameters": [HttpQueryParameter],
  "url": "xyz789"
}

UrlRewriteEntityTypeEnum

This enumeration defines the entity type.

Values

Enum Value
Description
CMS_PAGE
PRODUCT
CATEGORY

Example

""CMS_PAGE""

UseInLayeredNavigationOptions

Defines whether the attribute is filterable in layered navigation.

Values

Enum Value
Description
NO
FILTERABLE_WITH_RESULTS
FILTERABLE_NO_RESULT

Example

""NO""

ValidatePurchaseOrderError

Contains details about a failed validation attempt.

Fields

Field Name
Description
message - String!
The returned error message.
type - ValidatePurchaseOrderErrorType!
Error type.

Example

{"message": "abc123", "type": "NOT_FOUND"}

ValidatePurchaseOrderErrorType

Values

Enum Value
Description
NOT_FOUND
OPERATION_NOT_APPLICABLE
COULD_NOT_SAVE
NOT_VALID_DATA
UNDEFINED

Example

""NOT_FOUND""

ValidatePurchaseOrdersInput

Defines the purchase orders to be validated.

Input Fields

Input Field
Description
purchase_order_uids - [ID]!
An array of the purchase order IDs.

Example

{"purchase_order_uids": ["4"]}

ValidatePurchaseOrdersOutput

Contains the results of validation attempts.

Fields

Field Name
Description
errors - [ValidatePurchaseOrderError]!
An array of error messages encountered while performing the operation.
purchase_orders - [PurchaseOrder]!
An array of the purchase orders in the request.

Example

{
  "errors": [ValidatePurchaseOrderError],
  "purchase_orders": [PurchaseOrder]
}

VaultTokenInput

Contains required input for payment methods with Vault support.

Input Fields

Input Field
Description
public_hash - String!
The public hash of the payment token.

Example

{"public_hash": "xyz789"}

VirtualCartItem

An implementation for virtual product cart items.

Fields

Field Name
Description
customizable_options - [SelectedCustomizableOption]!
An array containing customizable options the shopper selected.
errors - [CartItemError]
An array of errors encountered while loading the cart item
id - String!
(Deprecated: Use `uid` instead.)
prices - CartItemPrices
Contains details about the price of the item, including taxes and discounts.
product - ProductInterface!
Details about an item in the cart.
quantity - Float!
The quantity of this item in the cart.
uid - ID!
The unique ID for a `CartItemInterface` object.

Example

{
  "customizable_options": [SelectedCustomizableOption],
  "errors": [CartItemError],
  "id": "abc123",
  "prices": CartItemPrices,
  "product": ProductInterface,
  "quantity": 987.65,
  "uid": "4"
}

VirtualProduct

Defines a virtual product, which is a non-tangible product that does not require shipping and is not kept in inventory.

Fields

Field Name
Description
activity - String
(Deprecated: Use the `custom_attributes` field instead.)
attribute_set_id - Int
The attribute set assigned to the product. (Deprecated: The field should not be used on the storefront.)
canonical_url - String
The relative canonical URL. This value is returned only if the system setting 'Use Canonical Link Meta Tag For Products' is enabled.
categories - [CategoryInterface]
The categories assigned to a product.
category_gear - String
(Deprecated: Use the `custom_attributes` field instead.)
climate - String
(Deprecated: Use the `custom_attributes` field instead.)
collar - String
(Deprecated: Use the `custom_attributes` field instead.)
color - Int
(Deprecated: Use the `custom_attributes` field instead.)
country_of_manufacture - String
The product's country of origin.
created_at - String
Timestamp indicating when the product was created. (Deprecated: The field should not be used on the storefront.)
crosssell_products - [ProductInterface]
An array of cross-sell products.
description - ComplexTextValue
Detailed information about the product. The value can include simple HTML tags.
eco_collection - Int
(Deprecated: Use the `custom_attributes` field instead.)
erin_recommends - Int
(Deprecated: Use the `custom_attributes` field instead.)
features_bags - String
(Deprecated: Use the `custom_attributes` field instead.)
format - Int
(Deprecated: Use the `custom_attributes` field instead.)
gender - String
(Deprecated: Use the `custom_attributes` field instead.)
gift_message_available - String
Indicates whether a gift message is available.
id - Int
The ID number assigned to the product. (Deprecated: Use the `uid` field instead.)
image - ProductImage
The relative path to the main image on the product page.
is_returnable - String
Indicates whether the product can be returned.
manufacturer - Int
A number representing the product's manufacturer. (Deprecated: Use the `custom_attributes` field instead.)
material - String
(Deprecated: Use the `custom_attributes` field instead.)
media_gallery - [MediaGalleryInterface]
An array of media gallery objects.
media_gallery_entries - [MediaGalleryEntry]
An array of MediaGalleryEntry objects. (Deprecated: Use `media_gallery` instead.)
meta_description - String
A brief overview of the product for search results listings, maximum 255 characters.
meta_keyword - String
A comma-separated list of keywords that are visible only to search engines.
meta_title - String
A string that is displayed in the title bar and tab of the browser and in search results lists.
name - String
The product name. Customers use this name to identify the product.
new - Int
(Deprecated: Use the `custom_attributes` field instead.)
new_from_date - String
The beginning date for new product listings, and determines if the product is featured as a new product.
new_to_date - String
The end date for new product listings.
only_x_left_in_stock - Float
Product stock only x left count
options - [CustomizableOptionInterface]
An array of options for a customizable product.
options_container - String
If the product has multiple options, determines where they appear on the product page.
pattern - String
(Deprecated: Use the `custom_attributes` field instead.)
performance_fabric - Int
(Deprecated: Use the `custom_attributes` field instead.)
price - ProductPrices
Indicates the price of an item. (Deprecated: Use `price_range` for product price information.)
price_range - PriceRange!
The range of prices for the product
price_tiers - [TierPrice]
An array of `TierPrice` objects.
product_links - [ProductLinksInterface]
An array of `ProductLinks` objects.
purpose - Int
(Deprecated: Use the `custom_attributes` field instead.)
rating_summary - Float!
The average of all the ratings given to the product.
redirect_code - Int!
Contains 0 when there is no redirect error. A value of 301 indicates the URL of the requested resource has been changed permanently, while a value of 302 indicates a temporary redirect.
related_products - [ProductInterface]
An array of related products.
relative_url - String
The internal relative URL. If the specified URL is a redirect, the query returns the redirected URL, not the original.
review_count - Int!
The total count of all the reviews given to the product.
reviews - ProductReviews!
The list of products reviews.
sale - Int
(Deprecated: Use the `custom_attributes` field instead.)
short_description - ComplexTextValue
A short description of the product. Its use depends on the theme.
size - Int
(Deprecated: Use the `custom_attributes` field instead.)
sku - String
A number or code assigned to a product to identify the product, options, price, and manufacturer.
sleeve - String
(Deprecated: Use the `custom_attributes` field instead.)
small_image - ProductImage
The relative path to the small image, which is used on catalog pages.
special_from_date - String
The beginning date that a product has a special price. (Deprecated: The field should not be used on the storefront.)
special_price - Float
The discounted price of the product.
special_to_date - String
The end date for a product with a special price.
staged - Boolean!
Indicates whether the product is staged for a future campaign.
stock_status - ProductStockStatus
Stock status of the product
strap_bags - String
(Deprecated: Use the `custom_attributes` field instead.)
style_bags - String
(Deprecated: Use the `custom_attributes` field instead.)
style_bottom - String
(Deprecated: Use the `custom_attributes` field instead.)
style_general - String
(Deprecated: Use the `custom_attributes` field instead.)
swatch_image - String
The file name of a swatch image.
thumbnail - ProductImage
The relative path to the product's thumbnail image.
tier_price - Float
The price when tier pricing is in effect and the items purchased threshold has been reached. (Deprecated: Use `price_tiers` for product tier price information.)
tier_prices - [ProductTierPrices]
An array of ProductTierPrices objects. (Deprecated: Use `price_tiers` for product tier price information.)
type - UrlRewriteEntityTypeEnum
One of PRODUCT, CATEGORY, or CMS_PAGE.
type_id - String
One of simple, virtual, bundle, downloadable, grouped, or configurable. (Deprecated: Use `__typename` instead.)
uid - ID!
The unique ID for a `ProductInterface` object.
updated_at - String
Timestamp indicating when the product was updated. (Deprecated: The field should not be used on the storefront.)
upsell_products - [ProductInterface]
An array of up-sell products.
url_key - String
The part of the URL that identifies the product
url_path - String
(Deprecated: Use product's `canonical_url` or url rewrites instead)
url_rewrites - [UrlRewrite]
URL rewrites list
url_suffix - String
The part of the product URL that is appended after the url key
websites - [Website]
An array of websites in which the product is available. (Deprecated: The field should not be used on the storefront.)

Example

{
  "activity": "xyz789",
  "attribute_set_id": 123,
  "canonical_url": "abc123",
  "categories": [CategoryInterface],
  "category_gear": "xyz789",
  "climate": "xyz789",
  "collar": "xyz789",
  "color": 987,
  "country_of_manufacture": "xyz789",
  "created_at": "xyz789",
  "crosssell_products": [ProductInterface],
  "description": ComplexTextValue,
  "eco_collection": 123,
  "erin_recommends": 123,
  "features_bags": "xyz789",
  "format": 123,
  "gender": "abc123",
  "gift_message_available": "xyz789",
  "id": 987,
  "image": ProductImage,
  "is_returnable": "abc123",
  "manufacturer": 123,
  "material": "abc123",
  "media_gallery": [MediaGalleryInterface],
  "media_gallery_entries": [MediaGalleryEntry],
  "meta_description": "xyz789",
  "meta_keyword": "xyz789",
  "meta_title": "abc123",
  "name": "xyz789",
  "new": 987,
  "new_from_date": "abc123",
  "new_to_date": "abc123",
  "only_x_left_in_stock": 123.45,
  "options": [CustomizableOptionInterface],
  "options_container": "xyz789",
  "pattern": "xyz789",
  "performance_fabric": 123,
  "price": ProductPrices,
  "price_range": PriceRange,
  "price_tiers": [TierPrice],
  "product_links": [ProductLinksInterface],
  "purpose": 987,
  "rating_summary": 123.45,
  "redirect_code": 987,
  "related_products": [ProductInterface],
  "relative_url": "abc123",
  "review_count": 123,
  "reviews": ProductReviews,
  "sale": 987,
  "short_description": ComplexTextValue,
  "size": 123,
  "sku": "xyz789",
  "sleeve": "xyz789",
  "small_image": ProductImage,
  "special_from_date": "xyz789",
  "special_price": 123.45,
  "special_to_date": "abc123",
  "staged": true,
  "stock_status": "IN_STOCK",
  "strap_bags": "xyz789",
  "style_bags": "abc123",
  "style_bottom": "xyz789",
  "style_general": "abc123",
  "swatch_image": "abc123",
  "thumbnail": ProductImage,
  "tier_price": 987.65,
  "tier_prices": [ProductTierPrices],
  "type": "CMS_PAGE",
  "type_id": "abc123",
  "uid": 4,
  "updated_at": "xyz789",
  "upsell_products": [ProductInterface],
  "url_key": "xyz789",
  "url_path": "xyz789",
  "url_rewrites": [UrlRewrite],
  "url_suffix": "abc123",
  "websites": [Website]
}

VirtualProductCartItemInput

Defines a single product to add to the cart.

Input Fields

Input Field
Description
customizable_options - [CustomizableOptionInput]
An array that defines customizable options for the product.
data - CartItemInput!
An object containing the `sku`, `quantity`, and other relevant information about the product.

Example

{
  "customizable_options": [CustomizableOptionInput],
  "data": CartItemInput
}

VirtualRequisitionListItem

Contains details about virtual products added to a requisition list.

Fields

Field Name
Description
customizable_options - [SelectedCustomizableOption]!
Selected custom options for an item in the requisition list.
product - ProductInterface!
Details about a requisition list item.
quantity - Float!
The amount added.
uid - ID!
The unique ID for the requisition list item.

Example

{
  "customizable_options": [SelectedCustomizableOption],
  "product": ProductInterface,
  "quantity": 123.45,
  "uid": 4
}

VirtualWishlistItem

Contains a virtual product wish list item.

Fields

Field Name
Description
added_at - String!
The date and time the item was added to the wish list.
customizable_options - [SelectedCustomizableOption]!
Custom options selected for the wish list item.
description - String
The description of the item.
id - ID!
The unique ID for a `WishlistItemInterface` object.
product - ProductInterface
Product details of the wish list item.
quantity - Float!
The quantity of this wish list item.

Example

{
  "added_at": "xyz789",
  "customizable_options": [SelectedCustomizableOption],
  "description": "abc123",
  "id": 4,
  "product": ProductInterface,
  "quantity": 987.65
}

Website

Deprecated. It should not be used on the storefront. Contains information about a website.

Fields

Field Name
Description
code - String
A code assigned to the website to identify it. (Deprecated: The field should not be used on the storefront.)
default_group_id - String
The default group ID of the website. (Deprecated: The field should not be used on the storefront.)
id - Int
The ID number assigned to the website. (Deprecated: The field should not be used on the storefront.)
is_default - Boolean
Indicates whether this is the default website. (Deprecated: The field should not be used on the storefront.)
name - String
The website name. Websites use this name to identify it easier. (Deprecated: The field should not be used on the storefront.)
sort_order - Int
The attribute to use for sorting websites. (Deprecated: The field should not be used on the storefront.)

Example

{
  "code": "xyz789",
  "default_group_id": "abc123",
  "id": 123,
  "is_default": true,
  "name": "abc123",
  "sort_order": 123
}

WishListUserInputError

An error encountered while performing operations with WishList.

Fields

Field Name
Description
code - WishListUserInputErrorType!
A wish list-specific error code.
message - String!
A localized error message.

Example

{
  "code": "PRODUCT_NOT_FOUND",
  "message": "abc123"
}

WishListUserInputErrorType

A list of possible error types.

Values

Enum Value
Description
PRODUCT_NOT_FOUND
UNDEFINED

Example

""PRODUCT_NOT_FOUND""

Wishlist

Contains a customer wish list.

Fields

Field Name
Description
id - ID
The unique ID for a `Wishlist` object.
items - [WishlistItem]
(Deprecated: Use the `items_v2` field instead.)
items_count - Int
The number of items in the wish list.
items_v2 - WishlistItems
An array of items in the customer's wish list.
name - String
The name of the wish list.
sharing_code - String
An encrypted code that Magento uses to link to the wish list.
updated_at - String
The time of the last modification to the wish list.
visibility - WishlistVisibilityEnum!
Indicates whether the wish list is public or private.

Example

{
  "id": 4,
  "items": [WishlistItem],
  "items_count": 123,
  "items_v2": WishlistItems,
  "name": "xyz789",
  "sharing_code": "xyz789",
  "updated_at": "abc123",
  "visibility": "PUBLIC"
}

WishlistCartUserInputError

Contains details about errors encountered when a customer added wish list items to the cart.

Fields

Field Name
Description
code - WishlistCartUserInputErrorType!
An error code that describes the error encountered.
message - String!
A localized error message.
wishlistId - ID!
The unique ID of the `Wishlist` object containing an error.
wishlistItemId - ID!
The unique ID of the wish list item containing an error.

Example

{
  "code": "PRODUCT_NOT_FOUND",
  "message": "xyz789",
  "wishlistId": "4",
  "wishlistItemId": "4"
}

WishlistCartUserInputErrorType

A list of possible error types.

Values

Enum Value
Description
PRODUCT_NOT_FOUND
NOT_SALABLE
INSUFFICIENT_STOCK
UNDEFINED

Example

""PRODUCT_NOT_FOUND""

WishlistItem

Contains details about a wish list item.

Fields

Field Name
Description
added_at - String
The time when the customer added the item to the wish list.
description - String
The customer's comment about this item.
id - Int
The unique ID for a `WishlistItem` object.
product - ProductInterface
Details about the wish list item.
qty - Float
The quantity of this wish list item

Example

{
  "added_at": "abc123",
  "description": "xyz789",
  "id": 987,
  "product": ProductInterface,
  "qty": 987.65
}

WishlistItemCopyInput

Specifies the IDs of items to copy and their quantities.

Input Fields

Input Field
Description
quantity - Float
The quantity of this item to copy to the destination wish list. This value can't be greater than the quantity in the source wish list.
wishlist_item_id - ID!
The unique ID of the `WishlistItemInterface` object to be copied.

Example

{
  "quantity": 987.65,
  "wishlist_item_id": "4"
}

WishlistItemInput

Defines the items to add to a wish list.

Input Fields

Input Field
Description
entered_options - [EnteredOptionInput]
An array of options that the customer entered.
parent_sku - String
For complex product types, the SKU of the parent product.
quantity - Float!
The amount or number of items to add.
selected_options - [ID]
An array of strings corresponding to options the customer selected.
sku - String!
The SKU of the product to add. For complex product types, specify the child product SKU.

Example

{
  "entered_options": [EnteredOptionInput],
  "parent_sku": "xyz789",
  "quantity": 123.45,
  "selected_options": [4],
  "sku": "abc123"
}

WishlistItemInterface

The interface for wish list items.

Fields

Field Name
Description
added_at - String!
The date and time the item was added to the wish list.
customizable_options - [SelectedCustomizableOption]!
Custom options selected for the wish list item.
description - String
The description of the item.
id - ID!
The unique ID for a `WishlistItemInterface` object.
product - ProductInterface
Product details of the wish list item.
quantity - Float!
The quantity of this wish list item.

Possible Types

Example

{
  "added_at": "xyz789",
  "customizable_options": [SelectedCustomizableOption],
  "description": "xyz789",
  "id": "4",
  "product": ProductInterface,
  "quantity": 123.45
}

WishlistItemMoveInput

Specifies the IDs of the items to move and their quantities.

Input Fields

Input Field
Description
quantity - Float
The quantity of this item to move to the destination wish list. This value can't be greater than the quantity in the source wish list.
wishlist_item_id - ID!
The unique ID of the `WishlistItemInterface` object to be moved.

Example

{"quantity": 123.45, "wishlist_item_id": 4}

WishlistItemUpdateInput

Defines updates to items in a wish list.

Input Fields

Input Field
Description
description - String
Customer-entered comments about the item.
entered_options - [EnteredOptionInput]
An array of options that the customer entered.
quantity - Float
The new amount or number of this item.
selected_options - [ID]
An array of strings corresponding to options the customer selected.
wishlist_item_id - ID!
The unique ID for a `WishlistItemInterface` object.

Example

{
  "description": "xyz789",
  "entered_options": [EnteredOptionInput],
  "quantity": 987.65,
  "selected_options": ["4"],
  "wishlist_item_id": 4
}

WishlistItems

Contains an array of items in a wish list.

Fields

Field Name
Description
items - [WishlistItemInterface]!
A list of items in the wish list.
page_info - SearchResultPageInfo
Contains pagination metadata.

Example

{
  "items": [WishlistItemInterface],
  "page_info": SearchResultPageInfo
}

WishlistOutput

Deprecated: Use the Wishlist type instead.

Fields

Field Name
Description
items - [WishlistItem]
An array of items in the customer's wish list (Deprecated: Use the `Wishlist.items` field instead.)
items_count - Int
The number of items in the wish list. (Deprecated: Use the `Wishlist.items_count` field instead.)
name - String
When multiple wish lists are enabled, the name the customer assigns to the wishlist. (Deprecated: This field is related to Commerce functionality and is always `null` in Open Source.)
sharing_code - String
An encrypted code that links to the wish list. (Deprecated: Use the `Wishlist.sharing_code` field instead.)
updated_at - String
The time of the last modification to the wish list. (Deprecated: Use the `Wishlist.updated_at` field instead.)

Example

{
  "items": [WishlistItem],
  "items_count": 123,
  "name": "abc123",
  "sharing_code": "xyz789",
  "updated_at": "xyz789"
}

WishlistVisibilityEnum

Defines the wish list visibility types.

Values

Enum Value
Description
PUBLIC
PRIVATE

Example

""PUBLIC""

createEmptyCartInput

Assigns a specific cart_id to the empty cart.

Input Fields

Input Field
Description
cart_id - String
The ID to assign to the cart.

Example

{"cart_id": "abc123"}