Types

AddBundleProductsToCartInput

Defines the bundle products to add to the cart.

Input Fields

Example

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

AddBundleProductsToCartOutput

Contains details about the cart after adding bundle products.

Fields

Example

{"cart": Cart}

AddConfigurableProductsToCartInput

Defines the configurable products to add to the cart.

Input Fields

Example

{
  "cart_id": "xyz789",
  "cart_items": [ConfigurableProductCartItemInput]
}

AddConfigurableProductsToCartOutput

Contains details about the cart after adding configurable products.

Fields

Example

{"cart": Cart}

AddDownloadableProductsToCartInput

Input Fields

Example

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

AddDownloadableProductsToCartOutput

Contains details about the cart after adding downloadable products.

Fields

Example

{"cart": Cart}

AddGiftRegistryRegistrantInput

Defines a new registrant.

Input Fields

Example

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

AddGiftRegistryRegistrantsOutput

Contains the results of a request to add registrants.

Fields

Example

{"gift_registry": GiftRegistry}

AddProductsToCartOutput

Contains details about the cart after adding products to it.

Fields

Example

{
  "cart": Cart,
  "user_errors": [CartUserInputError]
}

AddProductsToCompareListInput

Contains products to add to an existing compare list.

Input Fields

Example

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

AddProductsToRequisitionListOutput

Output of the request to add products to a requisition list.

Fields

Example

{"requisition_list": RequisitionList}

AddProductsToWishlistOutput

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

Fields

Example

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

AddPurchaseOrderCommentInput

Contains the comment to be added to a purchase order.

Input Fields

Example

{
  "comment": "xyz789",
  "purchase_order_uid": "4"
}

AddPurchaseOrderCommentOutput

Contains the successfully added comment.

Fields

Example

{"comment": PurchaseOrderComment}

AddPurchaseOrderItemsToCartInput

Defines the purchase order and cart to act on.

Input Fields

Example

{
  "cart_id": "abc123",
  "purchase_order_uid": "4",
  "replace_existing_cart_items": true
}

AddRequisitionListItemToCartUserError

Contains details about why an attempt to add items to the requistion list failed.

Fields

Example

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

AddRequisitionListItemToCartUserErrorType

Values

Example

""OUT_OF_STOCK""

AddRequisitionListItemsToCartOutput

Output of the request to add items in a requisition list to the cart.

Fields

Example

{
  "add_requisition_list_items_to_cart_user_errors": [
    AddRequisitionListItemToCartUserError
  ],
  "cart": Cart,
  "status": false
}

AddReturnCommentInput

Defines a return comment.

Input Fields

Example

{
  "comment_text": "xyz789",
  "return_uid": "4"
}

AddReturnCommentOutput

Contains details about the return request.

Fields

Example

{"return": Return}

AddReturnTrackingInput

Defines tracking information to be added to the return.

Input Fields

Example

{
  "carrier_uid": 4,
  "return_uid": 4,
  "tracking_number": "xyz789"
}

AddReturnTrackingOutput

Contains the response after adding tracking information.

Fields

Example

{
  "return": Return,
  "return_shipping_tracking": ReturnShippingTracking
}

AddSimpleProductsToCartInput

Defines the simple and group products to add to the cart.

Input Fields

Example

{
  "cart_id": "xyz789",
  "cart_items": [SimpleProductCartItemInput]
}

AddSimpleProductsToCartOutput

Contains details about the cart after adding simple or group products.

Fields

Example

{"cart": Cart}

AddVirtualProductsToCartInput

Defines the virtual products to add to the cart.

Input Fields

Example

{
  "cart_id": "xyz789",
  "cart_items": [VirtualProductCartItemInput]
}

AddVirtualProductsToCartOutput

Contains details about the cart after adding virtual products.

Fields

Example

{"cart": Cart}

AddWishlistItemsToCartOutput

Contains the resultant wish list and any error information.

Fields

Example

{
  "add_wishlist_items_to_cart_user_errors": [
    WishlistCartUserInputError
  ],
  "status": true,
  "wishlist": Wishlist
}

Aggregation

Contains information for each filterable option (such as price, category UID, and custom attributes).

Fields

Example

{
  "attribute_code": "xyz789",
  "count": 123,
  "label": "abc123",
  "options": [AggregationOption],
  "position": 123
}

AggregationOption

An implementation of AggregationOptionInterface.

Fields

Example

{
  "count": 123,
  "label": "xyz789",
  "value": "xyz789"
}

AggregationOptionInterface

Defines aggregation option fields.

Fields

Possible Types

Example

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

AggregationsCategoryFilterInput

Filter category aggregations in layered navigation.

Input Fields

Example

{"includeDirectChildrenOnly": true}

AggregationsFilterInput

An input object that specifies the filters used in product aggregations.

Input Fields

Example

{"category": AggregationsCategoryFilterInput}

AppliedCoupon

Contains the applied coupon code.

Fields

Example

{"code": "xyz789"}

AppliedGiftCard

Contains an applied gift card with applied and remaining balance.

Fields

Example

{
  "applied_balance": Money,
  "code": "abc123",
  "current_balance": Money,
  "expiration_date": "xyz789"
}

AppliedStoreCredit

Contains the applied and current balances.

Fields

Example

{
  "applied_balance": Money,
  "current_balance": Money,
  "enabled": true
}

ApplyCouponToCartInput

Specifies the coupon code to apply to the cart.

Input Fields

Example

{
  "cart_id": "abc123",
  "coupon_code": "abc123"
}

ApplyCouponToCartOutput

Contains details about the cart after applying a coupon.

Fields

Example

{"cart": Cart}

ApplyGiftCardToCartInput

Defines the input required to run the applyGiftCardToCart mutation.

Input Fields

Example

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

ApplyGiftCardToCartOutput

Defines the possible output for the applyGiftCardToCart mutation.

Fields

Example

{"cart": Cart}

ApplyRewardPointsToCartOutput

Contains the customer cart.

Fields

Example

{"cart": Cart}

ApplyStoreCreditToCartInput

Defines the input required to run the applyStoreCreditToCart mutation.

Input Fields

Example

{"cart_id": "abc123"}

ApplyStoreCreditToCartOutput

Defines the possible output for the applyStoreCreditToCart mutation.

Fields

Example

{"cart": Cart}

AreaInput

AreaInput defines the parameters which will be used for filter by specified location.

Input Fields

Example

{"radius": 123, "search_term": "xyz789"}

AssignCompareListToCustomerOutput

Contains the results of the request to assign a compare list.

Fields

Example

{"compare_list": CompareList, "result": false}

Attribute

Contains details about the attribute, including the code and type.

Fields

Example

{
  "attribute_code": "xyz789",
  "attribute_options": [AttributeOption],
  "attribute_type": "abc123",
  "entity_type": "xyz789",
  "input_type": "abc123",
  "storefront_properties": StorefrontProperties
}

AttributeInput

Defines the attribute characteristics to search for the attribute_code and entity_type to search.

Input Fields

Example

{
  "attribute_code": "xyz789",
  "entity_type": "abc123"
}

AttributeOption

Defines an attribute option.

Fields

Example

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

AvailableCurrency

Defines the code and symbol of a currency that can be used for purchase orders.

Fields

Example

{"code": "AFN", "symbol": "xyz789"}

AvailablePaymentMethod

Describes a payment method that the shopper can use to pay for the order.

Fields

Example

{
  "code": "abc123",
  "is_deferred": true,
  "title": "abc123"
}

AvailableShippingMethod

Contains details about the possible shipping methods and carriers.

Fields

Example

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

BatchMutationStatus

Values

Example

""SUCCESS""

BillingAddressInput

Defines the billing address.

Input Fields

Example

{
  "address": CartAddressInput,
  "customer_address_id": 123,
  "same_as_shipping": false,
  "use_for_shipping": false
}

BillingCartAddress

Contains details about the billing address.

Fields

Example

{
  "city": "xyz789",
  "company": "xyz789",
  "country": CartAddressCountry,
  "customer_notes": "xyz789",
  "firstname": "abc123",
  "lastname": "xyz789",
  "postcode": "abc123",
  "region": CartAddressRegion,
  "street": ["xyz789"],
  "telephone": "abc123",
  "uid": "xyz789",
  "vat_id": "abc123"
}

Boolean

The Boolean scalar type represents true or false.

BraintreeCcVaultInput

Input Fields

Example

{
  "device_data": "xyz789",
  "public_hash": "xyz789"
}

BraintreeInput

Input Fields

Example

{
  "device_data": "abc123",
  "is_active_payment_token_enabler": true,
  "payment_method_nonce": "xyz789"
}

Breadcrumb

Contains details about an individual category that comprises a breadcrumb.

Fields

Example

{
  "category_id": 987,
  "category_level": 123,
  "category_name": "xyz789",
  "category_uid": "4",
  "category_url_key": "xyz789",
  "category_url_path": "xyz789"
}

BundleCartItem

An implementation for bundle product cart items.

Fields

Example

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

BundleCreditMemoItem

Defines bundle product options for CreditMemoItemInterface.

Fields

Example

{
  "bundle_options": [ItemSelectedBundleOption],
  "discounts": [Discount],
  "id": "4",
  "order_item": OrderItemInterface,
  "product_name": "abc123",
  "product_sale_price": Money,
  "product_sku": "abc123",
  "quantity_refunded": 123.45
}

BundleInvoiceItem

Defines bundle product options for InvoiceItemInterface.

Fields

Example

{
  "bundle_options": [ItemSelectedBundleOption],
  "discounts": [Discount],
  "id": 4,
  "order_item": OrderItemInterface,
  "product_name": "xyz789",
  "product_sale_price": Money,
  "product_sku": "xyz789",
  "quantity_invoiced": 987.65
}

BundleItem

Defines an individual item within a bundle product.

Fields

Example

{
  "option_id": 987,
  "options": [BundleItemOption],
  "position": 987,
  "price_range": PriceRange,
  "required": false,
  "sku": "xyz789",
  "title": "abc123",
  "type": "xyz789",
  "uid": 4
}

BundleItemOption

Defines the characteristics that comprise a specific bundle item and its options.

Fields

Example

{
  "can_change_quantity": false,
  "id": 123,
  "is_default": true,
  "label": "xyz789",
  "position": 123,
  "price": 987.65,
  "price_type": "FIXED",
  "product": ProductInterface,
  "qty": 987.65,
  "quantity": 123.45,
  "uid": "4"
}

BundleOptionInput

Defines the input for a bundle option.

Input Fields

Example

{
  "id": 987,
  "quantity": 987.65,
  "value": ["abc123"]
}

BundleOrderItem

Defines bundle product options for OrderItemInterface.

Fields

Example

{
  "bundle_options": [ItemSelectedBundleOption],
  "discounts": [Discount],
  "eligible_for_return": true,
  "entered_options": [OrderItemOption],
  "gift_message": GiftMessage,
  "gift_wrapping": GiftWrapping,
  "id": 4,
  "product_name": "abc123",
  "product_sale_price": Money,
  "product_sku": "abc123",
  "product_type": "abc123",
  "product_url_key": "abc123",
  "quantity_canceled": 987.65,
  "quantity_invoiced": 123.45,
  "quantity_ordered": 987.65,
  "quantity_refunded": 987.65,
  "quantity_returned": 123.45,
  "quantity_shipped": 123.45,
  "selected_options": [OrderItemOption],
  "status": "abc123"
}

BundleProduct

Defines basic features of a bundle product and contains multiple BundleItems.

Fields

Example

{
  "activity": "xyz789",
  "attribute_set_id": 987,
  "canonical_url": "abc123",
  "categories": [CategoryInterface],
  "category_gear": "xyz789",
  "climate": "xyz789",
  "collar": "abc123",
  "color": 987,
  "country_of_manufacture": "xyz789",
  "created_at": "abc123",
  "crosssell_products": [ProductInterface],
  "description": ComplexTextValue,
  "dynamic_price": false,
  "dynamic_sku": false,
  "dynamic_weight": true,
  "eco_collection": 123,
  "erin_recommends": 123,
  "features_bags": "abc123",
  "format": 987,
  "gender": "abc123",
  "gift_message_available": "xyz789",
  "id": 987,
  "image": ProductImage,
  "is_returnable": "abc123",
  "items": [BundleItem],
  "manufacturer": 123,
  "material": "abc123",
  "media_gallery": [MediaGalleryInterface],
  "media_gallery_entries": [MediaGalleryEntry],
  "meta_description": "xyz789",
  "meta_keyword": "xyz789",
  "meta_title": "xyz789",
  "name": "abc123",
  "new": 987,
  "new_from_date": "abc123",
  "new_to_date": "abc123",
  "only_x_left_in_stock": 987.65,
  "options": [CustomizableOptionInterface],
  "options_container": "abc123",
  "pattern": "xyz789",
  "performance_fabric": 987,
  "price": ProductPrices,
  "price_range": PriceRange,
  "price_tiers": [TierPrice],
  "price_view": "PRICE_RANGE",
  "product_links": [ProductLinksInterface],
  "purpose": 987,
  "rating_summary": 123.45,
  "redirect_code": 987,
  "related_products": [ProductInterface],
  "relative_url": "abc123",
  "review_count": 123,
  "reviews": ProductReviews,
  "sale": 123,
  "ship_bundle_items": "TOGETHER",
  "short_description": ComplexTextValue,
  "size": 123,
  "sku": "abc123",
  "sleeve": "abc123",
  "small_image": ProductImage,
  "special_from_date": "xyz789",
  "special_price": 123.45,
  "special_to_date": "abc123",
  "staged": true,
  "stock_status": "IN_STOCK",
  "strap_bags": "abc123",
  "style_bags": "xyz789",
  "style_bottom": "xyz789",
  "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": "abc123",
  "upsell_products": [ProductInterface],
  "url_key": "xyz789",
  "url_path": "xyz789",
  "url_rewrites": [UrlRewrite],
  "url_suffix": "xyz789",
  "websites": [Website],
  "weight": 987.65
}

BundleProductCartItemInput

Defines a single bundle product.

Input Fields

Example

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

BundleRequisitionListItem

Contains details about bundle products added to a requisition list.

Fields

Example

{
  "bundle_options": [SelectedBundleOption],
  "customizable_options": [SelectedCustomizableOption],
  "product": ProductInterface,
  "quantity": 987.65,
  "uid": "4"
}

BundleShipmentItem

Defines bundle product options for ShipmentItemInterface.

Fields

Example

{
  "bundle_options": [ItemSelectedBundleOption],
  "id": 4,
  "order_item": OrderItemInterface,
  "product_name": "xyz789",
  "product_sale_price": Money,
  "product_sku": "xyz789",
  "quantity_shipped": 123.45
}

BundleWishlistItem

Defines bundle product options for WishlistItemInterface.

Fields

Example

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