Types

CancelNegotiableQuoteTemplateInput

Specifies the quote template id of the quote template to cancel

Input Fields

Input Field
Description
cancellation_comment - String
A comment to provide reason of cancellation.
template_id - ID!
The unique ID of a NegotiableQuoteTemplate object.

Example

{
  "cancellation_comment": "xyz789",
  "template_id": "4"
}

CancelOrderInput

Defines the order to cancel.

Input Fields

Input Field
Description
order_id - ID!
Order ID.
reason - String!
Cancellation reason.

Example

{"order_id": 4, "reason": "abc123"}

CancelOrderOutput

Contains the updated customer order and error message if any.

Fields

Field Name
Description
error - String
Error encountered while cancelling the order.
order - CustomerOrder
Updated customer order.

Example

{
  "error": "xyz789",
  "order": CustomerOrder
}

CancellationReason

Fields

Field Name
Description
description - String!

Example

{"description": "abc123"}

Card

Fields

Field Name
Description
bin_details - CardBin
Card bin details
card_expiry_month - String
Expiration month of the card
card_expiry_year - String
Expiration year of the card
last_digits - String
Last four digits of the card
name - String
Name on the card

Example

{
  "bin_details": CardBin,
  "card_expiry_month": "xyz789",
  "card_expiry_year": "xyz789",
  "last_digits": "xyz789",
  "name": "abc123"
}

CardBin

Fields

Field Name
Description
bin - String
Card bin number

Example

{"bin": "abc123"}

Cart

Contains the contents and other details about a guest or customer cart.

Fields

Field Name
Description
applied_coupon - AppliedCoupon
(Deprecated: Use applied_coupons instead.)
applied_coupons - [AppliedCoupon]
An array of AppliedCoupon objects. Each object contains the code text attribute, which specifies the coupon code.
applied_gift_cards - [AppliedGiftCard]
An array of gift card items applied to the cart.
applied_reward_points - RewardPointsAmount
The amount of reward points applied to the cart.
applied_store_credit - AppliedStoreCredit
Store credit information applied to the cart.
available_gift_wrappings - [GiftWrapping]!
The list of available gift wrapping options for the cart.
available_payment_methods - [AvailablePaymentMethod]
An array of available payment methods.
billing_address - BillingCartAddress
The billing address assigned to the cart.
email - String
The email address of the guest or customer.
gift_message - GiftMessage
The entered gift message for the cart
gift_receipt_included - Boolean!
Indicates whether the shopper requested gift receipt for the cart.
gift_wrapping - GiftWrapping
The selected gift wrapping for the cart.
id - ID!
The unique ID for a Cart object.
is_virtual - Boolean!
Indicates whether the cart contains only virtual products.
items - [CartItemInterface]
An array of products that have been added to the cart. (Deprecated: Use itemsV2 instead.)
itemsV2 - CartItems
prices - CartPrices
Pricing details for the quote.
printed_card_included - Boolean!
Indicates whether the shopper requested a printed card for the cart.
selected_payment_method - SelectedPaymentMethod
Indicates which payment method was applied to the cart.
shipping_addresses - [ShippingCartAddress]!
An array of shipping addresses assigned to the cart.
total_quantity - Float!
The total number of items in the cart.

Example

{
  "applied_coupon": AppliedCoupon,
  "applied_coupons": [AppliedCoupon],
  "applied_gift_cards": [AppliedGiftCard],
  "applied_reward_points": RewardPointsAmount,
  "applied_store_credit": AppliedStoreCredit,
  "available_gift_wrappings": [GiftWrapping],
  "available_payment_methods": [AvailablePaymentMethod],
  "billing_address": BillingCartAddress,
  "email": "xyz789",
  "gift_message": GiftMessage,
  "gift_receipt_included": true,
  "gift_wrapping": GiftWrapping,
  "id": "4",
  "is_virtual": true,
  "items": [CartItemInterface],
  "itemsV2": CartItems,
  "prices": CartPrices,
  "printed_card_included": false,
  "selected_payment_method": SelectedPaymentMethod,
  "shipping_addresses": [ShippingCartAddress],
  "total_quantity": 987.65
}

CartAddressCountry

Contains details the country in a billing or shipping address.

Fields

Field Name
Description
code - String!
The country code.
label - String!
The display label for the country.

Example

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

CartAddressInput

Defines the billing or shipping address to be applied to the cart.

Input Fields

Input Field
Description
city - String!
The city specified for the billing or shipping address.
company - String
The company specified for the billing or shipping address.
country_code - String!
The country code and label for the billing or shipping address.
custom_attributes - [AttributeValueInput]
The custom attribute values of the billing or shipping address.
fax - String
The customer's fax number.
firstname - String!
The first name of the customer or guest.
lastname - String!
The last name of the customer or guest.
middlename - String
The middle name of the person associated with the billing/shipping address.
postcode - String
The ZIP or postal code of the billing or shipping address.
prefix - String
An honorific, such as Dr., Mr., or Mrs.
region - String
A string that defines the state or province of the billing or shipping address.
region_id - Int
An integer that defines the state or province of the billing or shipping address.
save_in_address_book - Boolean
Determines whether to save the address in the customer's address book. The default value is true.
street - [String]!
An array containing the street for the billing or shipping address.
suffix - String
A value such as Sr., Jr., or III.
telephone - String
The telephone number for the billing or shipping address.
vat_id - String
The VAT company number for billing or shipping address.

Example

{
  "city": "abc123",
  "company": "abc123",
  "country_code": "abc123",
  "custom_attributes": [AttributeValueInput],
  "fax": "abc123",
  "firstname": "xyz789",
  "lastname": "abc123",
  "middlename": "abc123",
  "postcode": "abc123",
  "prefix": "xyz789",
  "region": "xyz789",
  "region_id": 987,
  "save_in_address_book": false,
  "street": ["xyz789"],
  "suffix": "xyz789",
  "telephone": "xyz789",
  "vat_id": "xyz789"
}

CartAddressInterface

Fields

Field Name
Description
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.
custom_attributes - [AttributeValueInterface]!
The custom attribute values of the billing or shipping address.
fax - String
The customer's fax number.
firstname - String!
The first name of the customer or guest.
lastname - String!
The last name of the customer or guest.
middlename - String
The middle name of the person associated with the billing/shipping address.
postcode - String
The ZIP or postal code of the billing or shipping address.
prefix - String
An honorific, such as Dr., Mr., or Mrs.
region - CartAddressRegion
An object containing the region label and code.
street - [String]!
An array containing the street for the billing or shipping address.
suffix - String
A value such as Sr., Jr., or III.
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.

Possible Types

CartAddressInterface Types
ShippingCartAddress
BillingCartAddress

Example

{
  "city": "abc123",
  "company": "xyz789",
  "country": CartAddressCountry,
  "custom_attributes": [AttributeValueInterface],
  "fax": "abc123",
  "firstname": "xyz789",
  "lastname": "abc123",
  "middlename": "abc123",
  "postcode": "xyz789",
  "prefix": "abc123",
  "region": CartAddressRegion,
  "street": ["xyz789"],
  "suffix": "abc123",
  "telephone": "xyz789",
  "uid": "abc123",
  "vat_id": "abc123"
}

CartAddressRegion

Contains details about the region in a billing or shipping address.

Fields

Field Name
Description
code - String
The state or province code.
label - String
The display label for the region.
region_id - Int
The unique ID for a pre-defined region.

Example

{
  "code": "abc123",
  "label": "xyz789",
  "region_id": 987
}

CartDiscount

Contains information about discounts applied to the cart.

Fields

Field Name
Description
amount - Money!
The amount of the discount applied to the item.
label - [String]!
The description of the discount.

Example

{
  "amount": Money,
  "label": ["abc123"]
}

CartDiscountType

Values

Enum Value
Description
ITEM
SHIPPING

Example

""ITEM""

CartItemError

Fields

Field Name
Description
code - CartItemErrorType!
An error code that describes the error encountered
message - String!
A localized error message

Example

{"code": "UNDEFINED", "message": "xyz789"}

CartItemErrorType

Values

Enum Value
Description
UNDEFINED
ITEM_QTY
ITEM_INCREMENTS

Example

""UNDEFINED""

CartItemInput

Defines an item to be added to the cart.

Input Fields

Input Field
Description
entered_options - [EnteredOptionInput]
An array of entered options for the base product, such as personalization text.
parent_sku - String
For a child product, the SKU of its parent product.
quantity - Float!
The amount or number of an item to add.
selected_options - [ID]
The selected options for the base product, such as color or size, using the unique ID for an object such as CustomizableRadioOption, CustomizableDropDownOption, or ConfigurableProductOptionsValues.
sku - String!
The SKU of the product.

Example

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

CartItemInterface

An interface for products in a cart.

Fields

Field Name
Description
discount - [Discount]
Contains discount for quote line item.
errors - [CartItemError]
An array of errors encountered while loading the cart item
id - String!
(Deprecated: Use uid instead.)
is_available - Boolean!
True if requested quantity is less than available stock, false otherwise.
max_qty - Float
Line item max qty in quote template
min_qty - Float
Line item min qty in quote template
note_from_buyer - [ItemNote]
The buyer's quote line item note.
note_from_seller - [ItemNote]
The seller's quote line item note.
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.

Possible Types

Example

{
  "discount": [Discount],
  "errors": [CartItemError],
  "id": "abc123",
  "is_available": false,
  "max_qty": 123.45,
  "min_qty": 987.65,
  "note_from_buyer": [ItemNote],
  "note_from_seller": [ItemNote],
  "prices": CartItemPrices,
  "product": ProductInterface,
  "quantity": 123.45,
  "uid": 4
}

CartItemPrices

Contains details about the price of the item, including taxes and discounts.

Fields

Field Name
Description
discounts - [Discount]
An array of discounts to be applied to the cart item.
fixed_product_taxes - [FixedProductTax]
An array of FPTs applied to the cart item.
price - Money!
The price of the item before any discounts were applied. The price that might include tax, depending on the configured display settings for cart.
price_including_tax - Money!
The price of the item before any discounts were applied. The price that might include tax, depending on the configured display settings for cart.
row_total - Money!
The value of the price multiplied by the quantity of the item.
row_total_including_tax - Money!
The value of row_total plus the tax applied to the item.
total_item_discount - Money
The total of all discounts applied to the item.

Example

{
  "discounts": [Discount],
  "fixed_product_taxes": [FixedProductTax],
  "price": Money,
  "price_including_tax": Money,
  "row_total": Money,
  "row_total_including_tax": Money,
  "total_item_discount": Money
}

CartItemQuantity

Deprecated: The ShippingCartAddress.cart_items field now returns CartItemInterface.

Fields

Field Name
Description
cart_item_id - Int!
(Deprecated: The ShippingCartAddress.cart_items field now returns CartItemInterface.)
quantity - Float!
(Deprecated: The ShippingCartAddress.cart_items field now returns CartItemInterface.)

Example

{"cart_item_id": 123, "quantity": 987.65}

CartItemSelectedOptionValuePrice

Contains details about the price of a selected customizable value.

Fields

Field Name
Description
type - PriceTypeEnum!
Indicates whether the price type is fixed, percent, or dynamic.
units - String!
A string that describes the unit of the value.
value - Float!
A price value.

Example

{
  "type": "FIXED",
  "units": "xyz789",
  "value": 987.65
}

CartItemUpdateInput

A single item to be updated.

Input Fields

Input Field
Description
cart_item_id - Int
Deprecated. Use cart_item_uid instead.
cart_item_uid - ID
The unique ID for a CartItemInterface object.
customizable_options - [CustomizableOptionInput]
An array that defines customizable options for the product.
gift_message - GiftMessageInput
Gift message details for the cart item
gift_wrapping_id - ID
The unique ID for a GiftWrapping object to be used for the cart item.
quantity - Float
The new quantity of the item.

Example

{
  "cart_item_id": 987,
  "cart_item_uid": "4",
  "customizable_options": [CustomizableOptionInput],
  "gift_message": GiftMessageInput,
  "gift_wrapping_id": 4,
  "quantity": 123.45
}

CartItems

Fields

Field Name
Description
items - [CartItemInterface]!
An array of products that have been added to the cart.
page_info - SearchResultPageInfo
Metadata for pagination rendering.
total_count - Int!
The number of returned cart items.

Example

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

CartPrices

Contains details about the final price of items in the cart, including discount and tax information.

Fields

Field Name
Description
applied_taxes - [CartTaxItem]
An array containing the names and amounts of taxes applied to each item in the cart.
discount - CartDiscount
(Deprecated: Use discounts instead.)
discounts - [Discount]
An array containing cart rule discounts, store credit and gift cards applied to the cart.
gift_options - GiftOptionsPrices
The list of prices for the selected gift options.
grand_total - Money
The total, including discounts, taxes, shipping, and other fees.
subtotal_excluding_tax - Money
The subtotal without any applied taxes.
subtotal_including_tax - Money
The subtotal including any applied taxes.
subtotal_with_discount_excluding_tax - Money
The subtotal with any discounts applied, but not taxes.

Example

{
  "applied_taxes": [CartTaxItem],
  "discount": CartDiscount,
  "discounts": [Discount],
  "gift_options": GiftOptionsPrices,
  "grand_total": Money,
  "subtotal_excluding_tax": Money,
  "subtotal_including_tax": Money,
  "subtotal_with_discount_excluding_tax": Money
}

CartTaxItem

Contains tax information about an item in the cart.

Fields

Field Name
Description
amount - Money!
The amount of tax applied to the item.
label - String!
The description of the tax.

Example

{
  "amount": Money,
  "label": "abc123"
}

CartUserInputError

An error encountered while adding an item to the the cart.

Fields

Field Name
Description
code - CartUserInputErrorType!
A cart-specific error code.
message - String!
A localized error message.

Example

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

CartUserInputErrorType

Values

Enum Value
Description
PRODUCT_NOT_FOUND
NOT_SALABLE
INSUFFICIENT_STOCK
UNDEFINED
PERMISSION_DENIED

Example

""PRODUCT_NOT_FOUND""

CatalogAttributeApplyToEnum

Values

Enum Value
Description
SIMPLE
VIRTUAL
BUNDLE
DOWNLOADABLE
CONFIGURABLE
GROUPED
CATEGORY

Example

""SIMPLE""

CatalogAttributeMetadata

Swatch attribute metadata.

Fields

Field Name
Description
apply_to - [CatalogAttributeApplyToEnum]
To which catalog types an attribute can be applied.
code - ID!
The unique identifier for an attribute code. This value should be in lowercase letters without spaces.
default_value - String
Default attribute value.
entity_type - AttributeEntityTypeEnum!
The type of entity that defines the attribute.
frontend_class - String
The frontend class of the attribute.
frontend_input - AttributeFrontendInputEnum
The frontend input type of the attribute.
is_comparable - Boolean
Whether a product or category attribute can be compared against another or not.
is_filterable - Boolean
Whether a product or category attribute can be filtered or not.
is_filterable_in_search - Boolean
Whether a product or category attribute can be filtered in search or not.
is_html_allowed_on_front - Boolean
Whether a product or category attribute can use HTML on front or not.
is_required - Boolean!
Whether the attribute value is required.
is_searchable - Boolean
Whether a product or category attribute can be searched or not.
is_unique - Boolean!
Whether the attribute value must be unique.
is_used_for_price_rules - Boolean
Whether a product or category attribute can be used for price rules or not.
is_used_for_promo_rules - Boolean
Whether a product or category attribute is used for promo rules or not.
is_visible_in_advanced_search - Boolean
Whether a product or category attribute is visible in advanced search or not.
is_visible_on_front - Boolean
Whether a product or category attribute is visible on front or not.
is_wysiwyg_enabled - Boolean
Whether a product or category attribute has WYSIWYG enabled or not.
label - String
The label assigned to the attribute.
options - [CustomAttributeOptionInterface]!
Attribute options.
swatch_input_type - SwatchInputTypeEnum
Input type of the swatch attribute option.
update_product_preview_image - Boolean
Whether update product preview image or not.
use_product_image_for_swatch - Boolean
Whether use product image for swatch or not.
used_in_product_listing - Boolean
Whether a product or category attribute is used in product listing or not.

Example

{
  "apply_to": ["SIMPLE"],
  "code": 4,
  "default_value": "abc123",
  "entity_type": "CATALOG_PRODUCT",
  "frontend_class": "abc123",
  "frontend_input": "BOOLEAN",
  "is_comparable": true,
  "is_filterable": false,
  "is_filterable_in_search": true,
  "is_html_allowed_on_front": false,
  "is_required": false,
  "is_searchable": false,
  "is_unique": true,
  "is_used_for_price_rules": true,
  "is_used_for_promo_rules": false,
  "is_visible_in_advanced_search": false,
  "is_visible_on_front": true,
  "is_wysiwyg_enabled": true,
  "label": "abc123",
  "options": [CustomAttributeOptionInterface],
  "swatch_input_type": "BOOLEAN",
  "update_product_preview_image": false,
  "use_product_image_for_swatch": true,
  "used_in_product_listing": true
}

CategoryFilterInput

Defines the filters to be used in the search. A filter contains at least one attribute, a comparison operator, and the value that is being searched for.

Input Fields

Input Field
Description
category_uid - FilterEqualTypeInput
Filter by the unique category ID for a CategoryInterface object.
ids - FilterEqualTypeInput
Deprecated: use 'category_uid' to filter uniquely identifiers of categories.
name - FilterMatchTypeInput
Filter by the display name of the category.
parent_category_uid - FilterEqualTypeInput
Filter by the unique parent category ID for a CategoryInterface object.
parent_id - FilterEqualTypeInput
Filter by the unique parent category ID for a CategoryInterface object.
url_key - FilterEqualTypeInput
Filter by the part of the URL that identifies the category.
url_path - FilterEqualTypeInput
Filter by the URL path for the category.

Example

{
  "category_uid": FilterEqualTypeInput,
  "ids": FilterEqualTypeInput,
  "name": FilterMatchTypeInput,
  "parent_category_uid": FilterEqualTypeInput,
  "parent_id": FilterEqualTypeInput,
  "url_key": FilterEqualTypeInput,
  "url_path": FilterEqualTypeInput
}

CategoryInterface

Contains the full set of attributes that can be returned in a category search.

Fields

Field Name
Description
automatic_sorting - String
available_sort_by - [String]
breadcrumbs - [Breadcrumb]
An array of breadcrumb items.
canonical_url - String
The relative canonical URL. This value is returned only if the system setting 'Use Canonical Link Meta Tag For Categories' is enabled.
children_count - String
cms_block - CmsBlock
Contains a category CMS block.
created_at - String
The timestamp indicating when the category was created. (Deprecated: The field should not be used on the storefront.)
custom_layout_update_file - String
default_sort_by - String
The attribute to use for sorting.
description - String
An optional description of the category.
display_mode - String
filter_price_range - Float
id - Int
An ID that uniquely identifies the category. (Deprecated: Use uid instead.)
image - String
include_in_menu - Int
is_anchor - Int
landing_page - Int
level - Int
The depth of the category within the tree.
meta_description - String
meta_keywords - String
meta_title - String
name - String
The display name of the category.
path - String
The full category path.
path_in_store - String
The category path within the store.
position - Int
The position of the category relative to other categories at the same level in tree.
product_count - Int
The number of products in the category that are marked as visible. By default, in complex products, parent products are visible, but their child products are not.
products - CategoryProducts
The list of products assigned to the category.
staged - Boolean!
Indicates whether the category is staged for a future campaign.
uid - ID!
The unique ID for a CategoryInterface object.
updated_at - String
The timestamp indicating when the category was updated. (Deprecated: The field should not be used on the storefront.)
url_key - String
The URL key assigned to the category.
url_path - String
The URL path assigned to the category.
url_suffix - String
The part of the category URL that is appended after the url key

Possible Types

CategoryInterface Types
CategoryTree

Example

{
  "automatic_sorting": "xyz789",
  "available_sort_by": ["xyz789"],
  "breadcrumbs": [Breadcrumb],
  "canonical_url": "abc123",
  "children_count": "abc123",
  "cms_block": CmsBlock,
  "created_at": "abc123",
  "custom_layout_update_file": "abc123",
  "default_sort_by": "xyz789",
  "description": "abc123",
  "display_mode": "abc123",
  "filter_price_range": 987.65,
  "id": 987,
  "image": "xyz789",
  "include_in_menu": 123,
  "is_anchor": 123,
  "landing_page": 987,
  "level": 987,
  "meta_description": "xyz789",
  "meta_keywords": "abc123",
  "meta_title": "abc123",
  "name": "abc123",
  "path": "xyz789",
  "path_in_store": "xyz789",
  "position": 987,
  "product_count": 123,
  "products": CategoryProducts,
  "staged": false,
  "uid": 4,
  "updated_at": "abc123",
  "url_key": "abc123",
  "url_path": "xyz789",
  "url_suffix": "xyz789"
}

CategoryProducts

Contains details about the products assigned to a category.

Fields

Field Name
Description
items - [ProductInterface]
An array of products that are assigned to the category.
page_info - SearchResultPageInfo
Pagination metadata.
total_count - Int
The number of products in the category that are marked as visible. By default, in complex products, parent products are visible, but their child products are not.

Example

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

CategoryResult

Contains a collection of CategoryTree objects and pagination information.

Fields

Field Name
Description
items - [CategoryTree]
A list of categories that match the filter criteria.
page_info - SearchResultPageInfo
An object that includes the page_info and currentPage values specified in the query.
total_count - Int
The total number of categories that match the criteria.

Example

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

CategoryTree

Contains the hierarchy of categories.

Fields

Field Name
Description
automatic_sorting - String
available_sort_by - [String]
breadcrumbs - [Breadcrumb]
An array of breadcrumb items.
canonical_url - String
The relative canonical URL. This value is returned only if the system setting 'Use Canonical Link Meta Tag For Categories' is enabled.
children - [CategoryTree]
A tree of child categories.
children_count - String
cms_block - CmsBlock
Contains a category CMS block.
created_at - String
The timestamp indicating when the category was created. (Deprecated: The field should not be used on the storefront.)
custom_layout_update_file - String
default_sort_by - String
The attribute to use for sorting.
description - String
An optional description of the category.
display_mode - String
filter_price_range - Float
id - Int
An ID that uniquely identifies the category. (Deprecated: Use uid instead.)
image - String
include_in_menu - Int
is_anchor - Int
landing_page - Int
level - Int
The depth of the category within the tree.
meta_description - String
meta_keywords - String
meta_title - String
name - String
The display name of the category.
path - String
The full category path.
path_in_store - String
The category path within the store.
position - Int
The position of the category relative to other categories at the same level in tree.
product_count - Int
The number of products in the category that are marked as visible. By default, in complex products, parent products are visible, but their child products are not.
products - CategoryProducts
The list of products assigned to the category.
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.
staged - Boolean!
Indicates whether the category is staged for a future campaign.
type - UrlRewriteEntityTypeEnum
One of PRODUCT, CATEGORY, or CMS_PAGE.
uid - ID!
The unique ID for a CategoryInterface object.
updated_at - String
The timestamp indicating when the category was updated. (Deprecated: The field should not be used on the storefront.)
url_key - String
The URL key assigned to the category.
url_path - String
The URL path assigned to the category.
url_suffix - String
The part of the category URL that is appended after the url key

Example

{
  "automatic_sorting": "xyz789",
  "available_sort_by": ["abc123"],
  "breadcrumbs": [Breadcrumb],
  "canonical_url": "abc123",
  "children": [CategoryTree],
  "children_count": "xyz789",
  "cms_block": CmsBlock,
  "created_at": "xyz789",
  "custom_layout_update_file": "xyz789",
  "default_sort_by": "xyz789",
  "description": "abc123",
  "display_mode": "xyz789",
  "filter_price_range": 987.65,
  "id": 123,
  "image": "xyz789",
  "include_in_menu": 123,
  "is_anchor": 123,
  "landing_page": 987,
  "level": 987,
  "meta_description": "abc123",
  "meta_keywords": "xyz789",
  "meta_title": "abc123",
  "name": "abc123",
  "path": "xyz789",
  "path_in_store": "xyz789",
  "position": 987,
  "product_count": 987,
  "products": CategoryProducts,
  "redirect_code": 123,
  "relative_url": "xyz789",
  "staged": true,
  "type": "CMS_PAGE",
  "uid": "4",
  "updated_at": "xyz789",
  "url_key": "xyz789",
  "url_path": "xyz789",
  "url_suffix": "abc123"
}

CheckoutAgreement

Defines details about an individual checkout agreement.

Fields

Field Name
Description
agreement_id - Int!
The ID for a checkout agreement.
checkbox_text - String!
The checkbox text for the checkout agreement.
content - String!
Required. The text of the agreement.
content_height - String
The height of the text box where the Terms and Conditions statement appears during checkout.
is_html - Boolean!
Indicates whether the content text is in HTML format.
mode - CheckoutAgreementMode!
Indicates whether agreements are accepted automatically or manually.
name - String!
The name given to the condition.

Example

{
  "agreement_id": 987,
  "checkbox_text": "abc123",
  "content": "xyz789",
  "content_height": "abc123",
  "is_html": true,
  "mode": "AUTO",
  "name": "xyz789"
}

CheckoutAgreementMode

Indicates how agreements are accepted.

Values

Enum Value
Description
AUTO
Conditions are automatically accepted upon checkout.
MANUAL
Shoppers must manually accept the conditions to place an order.

Example

""AUTO""

CheckoutUserInputError

An error encountered while adding an item to the cart.

Fields

Field Name
Description
code - CheckoutUserInputErrorCodes!
An error code that is specific to Checkout.
message - String!
A localized error message.
path - [String]!
The path to the input field that caused an error. See the GraphQL specification about path errors for details: http://spec.graphql.org/draft/#sec-Errors

Example

{
  "code": "REORDER_NOT_AVAILABLE",
  "message": "xyz789",
  "path": ["xyz789"]
}

CheckoutUserInputErrorCodes

Values

Enum Value
Description
REORDER_NOT_AVAILABLE
PRODUCT_NOT_FOUND
NOT_SALABLE
INSUFFICIENT_STOCK
UNDEFINED

Example

""REORDER_NOT_AVAILABLE""

ClearCartError

Contains details about errors encountered when a customer clear cart.

Fields

Field Name
Description
message - String!
A localized error message
type - ClearCartErrorType!
A cart-specific error type.

Example

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

ClearCartErrorType

Values

Enum Value
Description
NOT_FOUND
UNAUTHORISED
INACTIVE
UNDEFINED

Example

""NOT_FOUND""

ClearCartInput

Assigns a specific cart_id to the empty cart.

Input Fields

Input Field
Description
uid - ID!
The unique ID of a Cart object.

Example

{"uid": 4}

ClearCartOutput

Output of the request to clear the customer cart.

Fields

Field Name
Description
cart - Cart
The cart after clear cart items.
errors - [ClearCartError]
An array of errors encountered while clearing the cart item

Example

{
  "cart": Cart,
  "errors": [ClearCartError]
}

ClearCustomerCartOutput

Output of the request to clear the customer cart.

Fields

Field Name
Description
cart - Cart
The cart after clearing items.
status - Boolean!
Indicates whether cart was cleared.

Example

{"cart": Cart, "status": false}

CloseNegotiableQuoteError

Types

Example

NegotiableQuoteInvalidStateError

CloseNegotiableQuoteOperationFailure

Contains details about a failed close operation on a negotiable quote.

Fields

Field Name
Description
errors - [CloseNegotiableQuoteError]!
An array of errors encountered while attempting close the negotiable quote.
quote_uid - ID!
The unique ID of a NegotiableQuote object.

Example

{
  "errors": [NegotiableQuoteInvalidStateError],
  "quote_uid": "4"
}

CloseNegotiableQuoteOperationResult

Types

Example

NegotiableQuoteUidOperationSuccess

CloseNegotiableQuotesInput

Defines the negotiable quotes to mark as closed.

Input Fields

Input Field
Description
quote_uids - [ID]!
A list of unique IDs from NegotiableQuote objects.

Example

{"quote_uids": ["4"]}

CloseNegotiableQuotesOutput

Contains the closed negotiable quotes and other negotiable quotes the company user can view.

Fields

Field Name
Description
closed_quotes - [NegotiableQuote]
An array containing the negotiable quotes that were just closed. (Deprecated: Use operation_results instead.)
negotiable_quotes - NegotiableQuotesOutput
A list of negotiable quotes that can be viewed by the logged-in customer
operation_results - [CloseNegotiableQuoteOperationResult]!
An array of closed negotiable quote UIDs and details about any errors.
result_status - BatchMutationStatus!
The status of the request to close one or more negotiable quotes.

Example

{
  "closed_quotes": [NegotiableQuote],
  "negotiable_quotes": NegotiableQuotesOutput,
  "operation_results": [
    NegotiableQuoteUidOperationSuccess
  ],
  "result_status": "SUCCESS"
}

CmsBlock

Contains details about a specific CMS block.

Fields

Field Name
Description
content - String
The content of the CMS block in raw HTML.
identifier - String
The CMS block identifier.
title - String
The title assigned to the CMS block.

Example

{
  "content": "xyz789",
  "identifier": "abc123",
  "title": "xyz789"
}

CmsBlocks

Contains an array CMS block items.

Fields

Field Name
Description
items - [CmsBlock]
An array of CMS blocks.

Example

{"items": [CmsBlock]}

CmsPage

Contains details about a CMS page.

Fields

Field Name
Description
content - String
The content of the CMS page in raw HTML.
content_heading - String
The heading that displays at the top of the CMS page.
identifier - String
The ID of a CMS page.
meta_description - String
A brief description of the page for search results listings.
meta_keywords - String
A brief description of the page for search results listings.
meta_title - String
A page title that is indexed by search engines and appears in search results listings.
page_layout - String
The design layout of the page, indicating the number of columns and navigation features used on the page.
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.
title - String
The name that appears in the breadcrumb trail navigation and in the browser title bar and tab.
type - UrlRewriteEntityTypeEnum
One of PRODUCT, CATEGORY, or CMS_PAGE.
url_key - String
The URL key of the CMS page, which is often based on the content_heading.

Example

{
  "content": "abc123",
  "content_heading": "abc123",
  "identifier": "abc123",
  "meta_description": "abc123",
  "meta_keywords": "xyz789",
  "meta_title": "abc123",
  "page_layout": "abc123",
  "redirect_code": 123,
  "relative_url": "abc123",
  "title": "abc123",
  "type": "CMS_PAGE",
  "url_key": "abc123"
}

ColorSwatchData

Fields

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

Example

{"value": "xyz789"}

CompaniesSortFieldEnum

The fields available for sorting the customer companies.

Values

Enum Value
Description
NAME
The name of the company.

Example

""NAME""

CompaniesSortInput

Specifies which field to sort on, and whether to return the results in ascending or descending order.

Input Fields

Input Field
Description
field - CompaniesSortFieldEnum!
The field for sorting the results.
order - SortEnum!
Indicates whether to return results in ascending or descending order.

Example

{"field": "NAME", "order": "ASC"}

Company

Contains the output schema for a company.

Fields

Field Name
Description
acl_resources - [CompanyAclResource]
The list of all resources defined within the company.
company_admin - Customer
An object containing information about the company administrator.
credit - CompanyCredit!
Company credit balances and limits.
credit_history - CompanyCreditHistory!
Details about the history of company credit operations.
email - String
The email address of the company contact.
id - ID!
The unique ID of a Company object.
legal_address - CompanyLegalAddress
The address where the company is registered to conduct business.
legal_name - String
The full legal name of the company.
name - String
The name of the company.
payment_methods - [String]
The list of payment methods available to a company.
reseller_id - String
The resale number that is assigned to the company for tax reporting purposes.
role - CompanyRole
A company role filtered by the unique ID of a CompanyRole object.
roles - CompanyRoles!
An object that contains a list of company roles.
sales_representative - CompanySalesRepresentative
An object containing information about the company sales representative.
structure - CompanyStructure
The company structure of teams and customers in depth-first order.
team - CompanyTeam
The company team data filtered by the unique ID for a CompanyTeam object.
user - Customer
A company user filtered by the unique ID of a Customer object.
users - CompanyUsers
An object that contains a list of company users based on activity status.
vat_tax_id - String
The value-added tax number that is assigned to the company by some jurisdictions for tax reporting purposes.

Example

{
  "acl_resources": [CompanyAclResource],
  "company_admin": Customer,
  "credit": CompanyCredit,
  "credit_history": CompanyCreditHistory,
  "email": "xyz789",
  "id": 4,
  "legal_address": CompanyLegalAddress,
  "legal_name": "abc123",
  "name": "abc123",
  "payment_methods": ["xyz789"],
  "reseller_id": "abc123",
  "role": CompanyRole,
  "roles": CompanyRoles,
  "sales_representative": CompanySalesRepresentative,
  "structure": CompanyStructure,
  "team": CompanyTeam,
  "user": Customer,
  "users": CompanyUsers,
  "vat_tax_id": "xyz789"
}

CompanyAclResource

Contains details about the access control list settings of a resource.

Fields

Field Name
Description
children - [CompanyAclResource]
An array of sub-resources.
id - ID!
The unique ID for a CompanyAclResource object.
sort_order - Int
The sort order of an ACL resource.
text - String
The label assigned to the ACL resource.

Example

{
  "children": [CompanyAclResource],
  "id": 4,
  "sort_order": 123,
  "text": "xyz789"
}

CompanyAdminInput

Defines the input schema for creating a company administrator.

Input Fields

Input Field
Description
email - String!
The email address of the company administrator.
firstname - String!
The company administrator's first name.
gender - Int
The company administrator's gender (Male - 1, Female - 2, Not Specified - 3).
job_title - String
The job title of the company administrator.
lastname - String!
The company administrator's last name.

Example

{
  "email": "abc123",
  "firstname": "abc123",
  "gender": 123,
  "job_title": "xyz789",
  "lastname": "abc123"
}

CompanyBasicInfo

The minimal required information to identify and display the company.

Fields

Field Name
Description
id - ID!
The unique ID of a Company object.
legal_name - String
The full legal name of the company.
name - String
The name of the company.

Example

{
  "id": 4,
  "legal_name": "abc123",
  "name": "abc123"
}

CompanyCreateInput

Defines the input schema for creating a new company.

Input Fields

Input Field
Description
company_admin - CompanyAdminInput!
Defines the company administrator.
company_email - String!
The email address of the company contact.
company_name - String!
The name of the company to create.
legal_address - CompanyLegalAddressCreateInput!
Defines legal address data of the company.
legal_name - String
The full legal name of the company.
reseller_id - String
The resale number that is assigned to the company for tax reporting purposes.
vat_tax_id - String
The value-added tax number that is assigned to the company by some jurisdictions for tax reporting purposes.

Example

{
  "company_admin": CompanyAdminInput,
  "company_email": "xyz789",
  "company_name": "xyz789",
  "legal_address": CompanyLegalAddressCreateInput,
  "legal_name": "abc123",
  "reseller_id": "abc123",
  "vat_tax_id": "abc123"
}

CompanyCredit

Contains company credit balances and limits.

Fields

Field Name
Description
available_credit - Money!
The sum of the credit limit and the outstanding balance. If the company has exceeded the credit limit, the amount is as a negative value.
credit_limit - Money!
The amount of credit extended to the company.
outstanding_balance - Money!
The amount reimbursed, less the total due from all orders placed using the Payment on Account payment method. The amount can be a positive or negative value.

Example

{
  "available_credit": Money,
  "credit_limit": Money,
  "outstanding_balance": Money
}

CompanyCreditHistory

Contains details about prior company credit operations.

Fields

Field Name
Description
items - [CompanyCreditOperation]!
An array of company credit operations.
page_info - SearchResultPageInfo!
Metadata for pagination rendering.
total_count - Int
The number of the company credit operations matching the specified filter.

Example

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

CompanyCreditHistoryFilterInput

Defines a filter for narrowing the results of a credit history search.

Input Fields

Input Field
Description
custom_reference_number - String
The purchase order number associated with the company credit operation.
operation_type - CompanyCreditOperationType
The type of the company credit operation.
updated_by - String
The name of the person submitting the company credit operation.

Example

{
  "custom_reference_number": "abc123",
  "operation_type": "ALLOCATION",
  "updated_by": "xyz789"
}

CompanyCreditOperation

Contains details about a single company credit operation.

Fields

Field Name
Description
amount - Money
The amount of the company credit operation.
balance - CompanyCredit!
The credit balance as a result of the operation.
custom_reference_number - String
The purchase order number associated with the company credit operation.
date - String!
The date the operation occurred.
type - CompanyCreditOperationType!
The type of the company credit operation.
updated_by - CompanyCreditOperationUser!
The company user that submitted the company credit operation.

Example

{
  "amount": Money,
  "balance": CompanyCredit,
  "custom_reference_number": "xyz789",
  "date": "xyz789",
  "type": "ALLOCATION",
  "updated_by": CompanyCreditOperationUser
}

CompanyCreditOperationType

Values

Enum Value
Description
ALLOCATION
UPDATE
PURCHASE
REIMBURSEMENT
REFUND
REVERT

Example

""ALLOCATION""

CompanyCreditOperationUser

Defines the administrator or company user that submitted a company credit operation.

Fields

Field Name
Description
name - String!
The name of the company user submitting the company credit operation.
type - CompanyCreditOperationUserType!
The type of the company user submitting the company credit operation.

Example

{"name": "xyz789", "type": "CUSTOMER"}

CompanyCreditOperationUserType

Values

Enum Value
Description
CUSTOMER
ADMIN

Example

""CUSTOMER""

CompanyInvitationInput

Defines the input schema for accepting the company invitation.

Input Fields

Input Field
Description
code - String!
The invitation code.
role_id - ID
The company role id.
user - CompanyInvitationUserInput!
Company user attributes in the invitation.

Example

{
  "code": "xyz789",
  "role_id": 4,
  "user": CompanyInvitationUserInput
}

CompanyInvitationOutput

The result of accepting the company invitation.

Fields

Field Name
Description
success - Boolean
Indicates whether the customer was added to the company successfully.

Example

{"success": true}

CompanyInvitationUserInput

Company user attributes in the invitation.

Input Fields

Input Field
Description
company_id - ID!
The company unique identifier.
customer_id - ID!
The customer unique identifier.
job_title - String
The job title of a company user.
status - CompanyUserStatusEnum
Indicates whether the company user is ACTIVE or INACTIVE.
telephone - String
The phone number of the company user.

Example

{
  "company_id": 4,
  "customer_id": "4",
  "job_title": "xyz789",
  "status": "ACTIVE",
  "telephone": "abc123"
}

CompanyLegalAddress

Contains details about the address where the company is registered to conduct business.

Fields

Field Name
Description
city - String
The city where the company is registered to conduct business.
country_code - CountryCodeEnum
The country code of the company's legal address.
postcode - String
The company's postal code.
region - CustomerAddressRegion
An object containing region data for the company.
street - [String]
An array of strings that define the company's street address.
telephone - String
The company's phone number.

Example

{
  "city": "abc123",
  "country_code": "AF",
  "postcode": "xyz789",
  "region": CustomerAddressRegion,
  "street": ["abc123"],
  "telephone": "abc123"
}

CompanyLegalAddressCreateInput

Defines the input schema for defining a company's legal address.

Input Fields

Input Field
Description
city - String!
The city where the company is registered to conduct business.
country_id - CountryCodeEnum!
The company's country ID. Use the countries query to get this value.
postcode - String!
The postal code of the company.
region - CustomerAddressRegionInput!
An object containing the region name and/or region ID where the company is registered to conduct business.
street - [String]!
An array of strings that define the street address where the company is registered to conduct business.
telephone - String!
The primary phone number of the company.

Example

{
  "city": "xyz789",
  "country_id": "AF",
  "postcode": "abc123",
  "region": CustomerAddressRegionInput,
  "street": ["xyz789"],
  "telephone": "xyz789"
}

CompanyLegalAddressUpdateInput

Defines the input schema for updating a company's legal address.

Input Fields

Input Field
Description
city - String
The city where the company is registered to conduct business.
country_id - CountryCodeEnum
The unique ID for a Country object.
postcode - String
The postal code of the company.
region - CustomerAddressRegionInput
An object containing the region name and/or region ID where the company is registered to conduct business.
street - [String]
An array of strings that define the street address where the company is registered to conduct business.
telephone - String
The primary phone number of the company.

Example

{
  "city": "abc123",
  "country_id": "AF",
  "postcode": "xyz789",
  "region": CustomerAddressRegionInput,
  "street": ["xyz789"],
  "telephone": "xyz789"
}

CompanyRole

Contails details about a single role.

Fields

Field Name
Description
id - ID!
The unique ID for a CompanyRole object.
name - String
The name assigned to the role.
permissions - [CompanyAclResource]
A list of permission resources defined for a role.
users_count - Int
The total number of users assigned the specified role.

Example

{
  "id": "4",
  "name": "xyz789",
  "permissions": [CompanyAclResource],
  "users_count": 123
}

CompanyRoleCreateInput

Defines the input schema for creating a company role.

Input Fields

Input Field
Description
name - String!
The name of the role to create.
permissions - [String]!
A list of resources the role can access.

Example

{
  "name": "abc123",
  "permissions": ["xyz789"]
}

CompanyRoleUpdateInput

Defines the input schema for updating a company role.

Input Fields

Input Field
Description
id - ID!
The unique ID for a CompanyRole object.
name - String
The name of the role to update.
permissions - [String]
A list of resources the role can access.

Example

{
  "id": "4",
  "name": "abc123",
  "permissions": ["xyz789"]
}

CompanyRoles

Contains an array of roles.

Fields

Field Name
Description
items - [CompanyRole]!
A list of company roles that match the specified filter criteria.
page_info - SearchResultPageInfo
Pagination metadata.
total_count - Int!
The total number of objects matching the specified filter.

Example

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

CompanySalesRepresentative

Contains details about a company sales representative.

Fields

Field Name
Description
email - String
The email address of the company sales representative.
firstname - String
The company sales representative's first name.
lastname - String
The company sales representative's last name.

Example

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

CompanyStructure

Contains an array of the individual nodes that comprise the company structure.

Fields

Field Name
Description
items - [CompanyStructureItem]
An array of elements in a company structure.

Example

{"items": [CompanyStructureItem]}

CompanyStructureEntity

Types

Union Types
CompanyTeam
Customer

Example

CompanyTeam

CompanyStructureItem

Defines an individual node in the company structure.

Fields

Field Name
Description
entity - CompanyStructureEntity
A union of CompanyTeam and Customer objects.
id - ID!
The unique ID for a CompanyStructureItem object.
parent_id - ID
The ID of the parent item in the company hierarchy.

Example

{
  "entity": CompanyTeam,
  "id": "4",
  "parent_id": "4"
}

CompanyStructureUpdateInput

Defines the input schema for updating the company structure.

Input Fields

Input Field
Description
parent_tree_id - ID!
The ID of a company that will be the new parent.
tree_id - ID!
The ID of the company team that is being moved to another parent.

Example

{
  "parent_tree_id": "4",
  "tree_id": "4"
}

CompanyTeam

Describes a company team.

Fields

Field Name
Description
description - String
An optional description of the team.
id - ID!
The unique ID for a CompanyTeam object.
name - String
The display name of the team.
structure_id - ID!
ID of the company structure

Example

{
  "description": "abc123",
  "id": 4,
  "name": "abc123",
  "structure_id": "4"
}

CompanyTeamCreateInput

Defines the input schema for creating a company team.

Input Fields

Input Field
Description
description - String
An optional description of the team.
name - String!
The display name of the team.
target_id - ID
The ID of a node within a company's structure. This ID will be the parent of the created team.

Example

{
  "description": "xyz789",
  "name": "xyz789",
  "target_id": 4
}

CompanyTeamUpdateInput

Defines the input schema for updating a company team.

Input Fields

Input Field
Description
description - String
An optional description of the team.
id - ID!
The unique ID of the CompanyTeam object to update.
name - String
The display name of the team.

Example

{
  "description": "abc123",
  "id": "4",
  "name": "abc123"
}

CompanyUpdateInput

Defines the input schema for updating a company.

Input Fields

Input Field
Description
company_email - String
The email address of the company contact.
company_name - String
The name of the company to update.
legal_address - CompanyLegalAddressUpdateInput
The legal address data of the company.
legal_name - String
The full legal name of the company.
reseller_id - String
The resale number that is assigned to the company for tax reporting purposes.
vat_tax_id - String
The value-added tax number that is assigned to the company by some jurisdictions for tax reporting purposes.

Example

{
  "company_email": "abc123",
  "company_name": "abc123",
  "legal_address": CompanyLegalAddressUpdateInput,
  "legal_name": "xyz789",
  "reseller_id": "abc123",
  "vat_tax_id": "xyz789"
}

CompanyUserCreateInput

Defines the input schema for creating a company user.

Input Fields

Input Field
Description
email - String!
The company user's email address
firstname - String!
The company user's first name.
job_title - String!
The company user's job title or function.
lastname - String!
The company user's last name.
role_id - ID!
The unique ID for a CompanyRole object.
status - CompanyUserStatusEnum!
Indicates whether the company user is ACTIVE or INACTIVE.
target_id - ID
The ID of a node within a company's structure. This ID will be the parent of the created company user.
telephone - String!
The company user's phone number.

Example

{
  "email": "xyz789",
  "firstname": "abc123",
  "job_title": "xyz789",
  "lastname": "abc123",
  "role_id": 4,
  "status": "ACTIVE",
  "target_id": "4",
  "telephone": "abc123"
}

CompanyUserStatusEnum

Defines the list of company user status values.

Values

Enum Value
Description
ACTIVE
Only active users.
INACTIVE
Only inactive users.

Example

""ACTIVE""

CompanyUserUpdateInput

Defines the input schema for updating a company user.

Input Fields

Input Field
Description
email - String
The company user's email address.
firstname - String
The company user's first name.
id - ID!
The unique ID of a Customer object.
job_title - String
The company user's job title or function.
lastname - String
The company user's last name.
role_id - ID
The unique ID for a CompanyRole object.
status - CompanyUserStatusEnum
Indicates whether the company user is ACTIVE or INACTIVE.
telephone - String
The company user's phone number.

Example

{
  "email": "xyz789",
  "firstname": "abc123",
  "id": "4",
  "job_title": "xyz789",
  "lastname": "abc123",
  "role_id": 4,
  "status": "ACTIVE",
  "telephone": "xyz789"
}

CompanyUsers

Contains details about company users.

Fields

Field Name
Description
items - [Customer]!
An array of CompanyUser objects that match the specified filter criteria.
page_info - SearchResultPageInfo
Pagination metadata.
total_count - Int!
The number of objects returned.

Example

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

CompanyUsersFilterInput

Defines the filter for returning a list of company users.

Input Fields

Input Field
Description
status - CompanyUserStatusEnum
The activity status to filter on.

Example

{"status": "ACTIVE"}

ComparableAttribute

Contains an attribute code that is used for product comparisons.

Fields

Field Name
Description
code - String!
An attribute code that is enabled for product comparisons.
label - String!
The label of the attribute code.

Example

{
  "code": "abc123",
  "label": "abc123"
}

ComparableItem

Defines an object used to iterate through items for product comparisons.

Fields

Field Name
Description
attributes - [ProductAttribute]!
An array of product attributes that can be used to compare products.
product - ProductInterface!
Details about a product in a compare list.
uid - ID!
The unique ID of an item in a compare list.

Example

{
  "attributes": [ProductAttribute],
  "product": ProductInterface,
  "uid": "4"
}

CompareList

Contains iterable information such as the array of items, the count, and attributes that represent the compare list.

Fields

Field Name
Description
attributes - [ComparableAttribute]
An array of attributes that can be used for comparing products.
item_count - Int!
The number of items in the compare list.
items - [ComparableItem]
An array of products to compare.
uid - ID!
The unique ID assigned to the compare list.

Example

{
  "attributes": [ComparableAttribute],
  "item_count": 987,
  "items": [ComparableItem],
  "uid": "4"
}

ComplexTextValue

Fields

Field Name
Description
html - String!
Text that can contain HTML tags.

Example

{"html": "xyz789"}

ConfigurableAttributeOption

Contains details about a configurable product attribute option.

Fields

Field Name
Description
code - String
The ID assigned to the attribute.
label - String
A string that describes the configurable attribute option.
uid - ID!
The unique ID for a ConfigurableAttributeOption object.
value_index - Int
A unique index number assigned to the configurable product option.

Example

{
  "code": "abc123",
  "label": "xyz789",
  "uid": 4,
  "value_index": 987
}

ConfigurableCartItem

An implementation for configurable product cart items.

Fields

Field Name
Description
available_gift_wrapping - [GiftWrapping]!
The list of available gift wrapping options for the cart item.
configurable_options - [SelectedConfigurableOption]!
An array containing the configuranle options the shopper selected.
configured_variant - ProductInterface!
Product details of the cart item.
customizable_options - [SelectedCustomizableOption]!
An array containing the customizable options the shopper selected.
discount - [Discount]
Contains discount for quote line item.
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.)
is_available - Boolean!
True if requested quantity is less than available stock, false otherwise.
max_qty - Float
Line item max qty in quote template
min_qty - Float
Line item min qty in quote template
note_from_buyer - [ItemNote]
The buyer's quote line item note.
note_from_seller - [ItemNote]
The seller's quote line item note.
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],
  "configurable_options": [SelectedConfigurableOption],
  "configured_variant": ProductInterface,
  "customizable_options": [SelectedCustomizableOption],
  "discount": [Discount],
  "errors": [CartItemError],
  "gift_message": GiftMessage,
  "gift_wrapping": GiftWrapping,
  "id": "xyz789",
  "is_available": false,
  "max_qty": 123.45,
  "min_qty": 123.45,
  "note_from_buyer": [ItemNote],
  "note_from_seller": [ItemNote],
  "prices": CartItemPrices,
  "product": ProductInterface,
  "quantity": 123.45,
  "uid": "4"
}

ConfigurableOptionAvailableForSelection

Describes configurable options that have been selected and can be selected as a result of the previous selections.

Fields

Field Name
Description
attribute_code - String!
An attribute code that uniquely identifies a configurable option.
option_value_uids - [ID]!
An array of selectable option value IDs.

Example

{
  "attribute_code": "abc123",
  "option_value_uids": ["4"]
}

ConfigurableProduct

Defines basic features of a configurable product and its simple product variants.

Fields

Field Name
Description
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.
color - Int
(Deprecated: Use the custom_attributes field instead.)
configurable_options - [ConfigurableProductOptions]
An array of options for the configurable product.
configurable_product_options_selection - ConfigurableProductOptionsSelection
An array of media gallery items and other details about selected configurable product options as well as details about remaining selectable options.
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.
custom_attributesV2 - ProductCustomAttributes
Product custom attributes.
description - ComplexTextValue
Detailed information about the product. The value can include simple HTML tags.
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.)
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_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.
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.
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.
short_description - ComplexTextValue
A short description of the product. Its use depends on the theme.
sku - String
A number or code assigned to a product to identify the product, options, price, and manufacturer.
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
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
variants - [ConfigurableVariant]
An array of simple product variants.
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

{
  "attribute_set_id": 987,
  "canonical_url": "abc123",
  "categories": [CategoryInterface],
  "color": 987,
  "configurable_options": [ConfigurableProductOptions],
  "configurable_product_options_selection": ConfigurableProductOptionsSelection,
  "country_of_manufacture": "xyz789",
  "created_at": "xyz789",
  "crosssell_products": [ProductInterface],
  "custom_attributesV2": ProductCustomAttributes,
  "description": ComplexTextValue,
  "gift_message_available": "xyz789",
  "id": 123,
  "image": ProductImage,
  "is_returnable": "xyz789",
  "manufacturer": 987,
  "media_gallery": [MediaGalleryInterface],
  "media_gallery_entries": [MediaGalleryEntry],
  "meta_description": "abc123",
  "meta_keyword": "xyz789",
  "meta_title": "xyz789",
  "name": "xyz789",
  "new_from_date": "xyz789",
  "new_to_date": "xyz789",
  "only_x_left_in_stock": 987.65,
  "options": [CustomizableOptionInterface],
  "options_container": "xyz789",
  "price": ProductPrices,
  "price_range": PriceRange,
  "price_tiers": [TierPrice],
  "product_links": [ProductLinksInterface],
  "rating_summary": 123.45,
  "redirect_code": 987,
  "related_products": [ProductInterface],
  "relative_url": "abc123",
  "review_count": 987,
  "reviews": ProductReviews,
  "short_description": ComplexTextValue,
  "sku": "abc123",
  "small_image": ProductImage,
  "special_from_date": "xyz789",
  "special_price": 987.65,
  "special_to_date": "abc123",
  "staged": false,
  "stock_status": "IN_STOCK",
  "swatch_image": "abc123",
  "thumbnail": ProductImage,
  "tier_price": 123.45,
  "tier_prices": [ProductTierPrices],
  "type": "CMS_PAGE",
  "type_id": "xyz789",
  "uid": 4,
  "updated_at": "abc123",
  "upsell_products": [ProductInterface],
  "url_key": "xyz789",
  "url_path": "abc123",
  "url_rewrites": [UrlRewrite],
  "url_suffix": "abc123",
  "variants": [ConfigurableVariant],
  "websites": [Website],
  "weight": 987.65
}

ConfigurableProductCartItemInput

Input Fields

Input Field
Description
customizable_options - [CustomizableOptionInput]
The ID and value of the option.
data - CartItemInput!
The quantity and SKU of the configurable product.
parent_sku - String
The SKU of the parent configurable product.
variant_sku - String
Deprecated. Use CartItemInput.sku instead.

Example

{
  "customizable_options": [CustomizableOptionInput],
  "data": CartItemInput,
  "parent_sku": "xyz789",
  "variant_sku": "abc123"
}

ConfigurableProductOption

Contains details about configurable product options.

Fields

Field Name
Description
attribute_code - String!
An attribute code that uniquely identifies a configurable option.
label - String!
The display name of the option.
uid - ID!
The unique ID of the configurable option.
values - [ConfigurableProductOptionValue]
An array of values that are applicable for this option.

Example

{
  "attribute_code": "abc123",
  "label": "xyz789",
  "uid": 4,
  "values": [ConfigurableProductOptionValue]
}

ConfigurableProductOptionValue

Defines a value for a configurable product option.

Fields

Field Name
Description
is_available - Boolean!
Indicates whether the product is available with this selected option.
is_use_default - Boolean!
Indicates whether the value is the default.
label - String!
The display name of the value.
swatch - SwatchDataInterface
The URL assigned to the thumbnail of the swatch image.
uid - ID!
The unique ID of the value.

Example

{
  "is_available": true,
  "is_use_default": false,
  "label": "xyz789",
  "swatch": SwatchDataInterface,
  "uid": 4
}

ConfigurableProductOptions

Defines configurable attributes for the specified product.

Fields

Field Name
Description
attribute_code - String
A string that identifies the attribute.
attribute_id - String
The ID assigned to the attribute. (Deprecated: Use attribute_uid instead.)
attribute_id_v2 - Int
The ID assigned to the attribute. (Deprecated: Use attribute_uid instead.)
attribute_uid - ID!
The unique ID for an Attribute object.
id - Int
The configurable option ID number assigned by the system. (Deprecated: Use uid instead.)
label - String
A displayed string that describes the configurable product option.
position - Int
A number that indicates the order in which the attribute is displayed.
product_id - Int
This is the same as a product's id field. (Deprecated: product_id is not needed and can be obtained from its parent.)
uid - ID!
The unique ID for a ConfigurableProductOptions object.
use_default - Boolean
Indicates whether the option is the default.
values - [ConfigurableProductOptionsValues]
An array that defines the value_index codes assigned to the configurable product.

Example

{
  "attribute_code": "abc123",
  "attribute_id": "xyz789",
  "attribute_id_v2": 123,
  "attribute_uid": 4,
  "id": 987,
  "label": "abc123",
  "position": 987,
  "product_id": 987,
  "uid": "4",
  "use_default": true,
  "values": [ConfigurableProductOptionsValues]
}

ConfigurableProductOptionsSelection

Contains metadata corresponding to the selected configurable options.

Fields

Field Name
Description
configurable_options - [ConfigurableProductOption]
An array of all possible configurable options.
media_gallery - [MediaGalleryInterface]
Product images and videos corresponding to the specified configurable options selection.
options_available_for_selection - [ConfigurableOptionAvailableForSelection]
The configurable options available for further selection based on the current selection.
variant - SimpleProduct
A variant represented by the specified configurable options selection. The value is expected to be null until selections are made for each configurable option.

Example

{
  "configurable_options": [ConfigurableProductOption],
  "media_gallery": [MediaGalleryInterface],
  "options_available_for_selection": [
    ConfigurableOptionAvailableForSelection
  ],
  "variant": SimpleProduct
}

ConfigurableProductOptionsValues

Contains the index number assigned to a configurable product option.

Fields

Field Name
Description
default_label - String
The label of the product on the default store.
label - String
The label of the product.
store_label - String
The label of the product on the current store.
swatch_data - SwatchDataInterface
Swatch data for a configurable product option.
uid - ID
The unique ID for a ConfigurableProductOptionsValues object.
use_default_value - Boolean
Indicates whether to use the default_label.
value_index - Int
A unique index number assigned to the configurable product option. (Deprecated: Use uid instead.)

Example

{
  "default_label": "xyz789",
  "label": "xyz789",
  "store_label": "abc123",
  "swatch_data": SwatchDataInterface,
  "uid": "4",
  "use_default_value": false,
  "value_index": 123
}

ConfigurableRequisitionListItem

Contains details about configurable products added to a requisition list.

Fields

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

Example

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

ConfigurableVariant

Contains all the simple product variants of a configurable product.

Fields

Field Name
Description
attributes - [ConfigurableAttributeOption]
An array of configurable attribute options.
product - SimpleProduct
An array of linked simple products.

Example

{
  "attributes": [ConfigurableAttributeOption],
  "product": SimpleProduct
}

ConfigurableWishlistItem

A configurable product wish list item.

Fields

Field Name
Description
added_at - String!
The date and time the item was added to the wish list.
child_sku - String!
The SKU of the simple product corresponding to a set of selected configurable options. (Deprecated: Use ConfigurableWishlistItem.configured_variant.sku instead.)
configurable_options - [SelectedConfigurableOption]
An array of selected configurable options.
configured_variant - ProductInterface
Product details of the selected variant. The value is null if some options are not configured.
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": "abc123",
  "child_sku": "abc123",
  "configurable_options": [SelectedConfigurableOption],
  "configured_variant": ProductInterface,
  "customizable_options": [SelectedCustomizableOption],
  "description": "abc123",
  "id": "4",
  "product": ProductInterface,
  "quantity": 123.45
}

ConfirmEmailInput

Contains details about a customer email address to confirm.

Input Fields

Input Field
Description
confirmation_key - String!
The key to confirm the email address.
email - String!
The email address to be confirmed.

Example

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

ConfirmationStatusEnum

List of account confirmation statuses.

Values

Enum Value
Description
ACCOUNT_CONFIRMED
Account confirmed
ACCOUNT_CONFIRMATION_NOT_REQUIRED
Account confirmation not required

Example

""ACCOUNT_CONFIRMED""

ContactUsInput

Input Fields

Input Field
Description
comment - String!
The shopper's comment to the merchant.
email - String!
The email address of the shopper.
name - String!
The full name of the shopper.
telephone - String
The shopper's telephone number.

Example

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

ContactUsOutput

Contains the status of the request.

Fields

Field Name
Description
status - Boolean!
Indicates whether the request was successful.

Example

{"status": true}

CopyItemsBetweenRequisitionListsInput

An input object that defines the items in a requisition list to be copied.

Input Fields

Input Field
Description
requisitionListItemUids - [ID]!
An array of IDs representing products copied from one requisition list to another.

Example

{"requisitionListItemUids": [4]}

CopyItemsFromRequisitionListsOutput

Output of the request to copy items to the destination requisition list.

Fields

Field Name
Description
requisition_list - RequisitionList
The destination requisition list after the items were copied.

Example

{"requisition_list": RequisitionList}

CopyProductsBetweenWishlistsOutput

Contains the source and target wish lists after copying products.

Fields

Field Name
Description
destination_wishlist - Wishlist!
The destination wish list containing the copied products.
source_wishlist - Wishlist!
The wish list that the products were copied from.
user_errors - [WishListUserInputError]!
An array of errors encountered while copying products in a wish list.

Example

{
  "destination_wishlist": Wishlist,
  "source_wishlist": Wishlist,
  "user_errors": [WishListUserInputError]
}

Country

Fields

Field Name
Description
available_regions - [Region]
An array of regions within a particular country.
full_name_english - String
The name of the country in English.
full_name_locale - String
The name of the country in the current locale.
id - String
The unique ID for a Country object.
three_letter_abbreviation - String
The three-letter abbreviation of the country, such as USA.
two_letter_abbreviation - String
The two-letter abbreviation of the country, such as US.

Example

{
  "available_regions": [Region],
  "full_name_english": "abc123",
  "full_name_locale": "xyz789",
  "id": "abc123",
  "three_letter_abbreviation": "abc123",
  "two_letter_abbreviation": "abc123"
}

CountryCodeEnum

The list of country codes.

Values

Enum Value
Description
AF
Afghanistan
AX
Åland Islands
AL
Albania
DZ
Algeria
AS
American Samoa
AD
Andorra
AO
Angola
AI
Anguilla
AQ
Antarctica
AG
Antigua & Barbuda
AR
Argentina
AM
Armenia
AW
Aruba
AU
Australia
AT
Austria
AZ
Azerbaijan
BS
Bahamas
BH
Bahrain
BD
Bangladesh
BB
Barbados
BY
Belarus
BE
Belgium
BZ
Belize
BJ
Benin
BM
Bermuda
BT
Bhutan
BO
Bolivia
BA
Bosnia & Herzegovina
BW
Botswana
BV
Bouvet Island
BR
Brazil
IO
British Indian Ocean Territory
VG
British Virgin Islands
BN
Brunei
BG
Bulgaria
BF
Burkina Faso
BI
Burundi
KH
Cambodia
CM
Cameroon
CA
Canada
CV
Cape Verde
KY
Cayman Islands
CF
Central African Republic
TD
Chad
CL
Chile
CN
China
CX
Christmas Island
CC
Cocos (Keeling) Islands
CO
Colombia
KM
Comoros
CG
Congo-Brazzaville
CD
Congo-Kinshasa
CK
Cook Islands
CR
Costa Rica
CI
Côte d’Ivoire
HR
Croatia
CU
Cuba
CY
Cyprus
CZ
Czech Republic
DK
Denmark
DJ
Djibouti
DM
Dominica
DO
Dominican Republic
EC
Ecuador
EG
Egypt
SV
El Salvador
GQ
Equatorial Guinea
ER
Eritrea
EE
Estonia
SZ
Eswatini
ET
Ethiopia
FK
Falkland Islands
FO
Faroe Islands
FJ
Fiji
FI
Finland
FR
France
GF
French Guiana
PF
French Polynesia
TF
French Southern Territories
GA
Gabon
GM
Gambia
GE
Georgia
DE
Germany
GH
Ghana
GI
Gibraltar
GR
Greece
GL
Greenland
GD
Grenada
GP
Guadeloupe
GU
Guam
GT
Guatemala
GG
Guernsey
GN
Guinea
GW
Guinea-Bissau
GY
Guyana
HT
Haiti
HM
Heard & McDonald Islands
HN
Honduras
HK
Hong Kong SAR China
HU
Hungary
IS
Iceland
IN
India
ID
Indonesia
IR
Iran
IQ
Iraq
IE
Ireland
IM
Isle of Man
IL
Israel
IT
Italy
JM
Jamaica
JP
Japan
JE
Jersey
JO
Jordan
KZ
Kazakhstan
KE
Kenya
KI
Kiribati
KW
Kuwait
KG
Kyrgyzstan
LA
Laos
LV
Latvia
LB
Lebanon
LS
Lesotho
LR
Liberia
LY
Libya
LI
Liechtenstein
LT
Lithuania
LU
Luxembourg
MO
Macau SAR China
MK
Macedonia
MG
Madagascar
MW
Malawi
MY
Malaysia
MV
Maldives
ML
Mali
MT
Malta
MH
Marshall Islands
MQ
Martinique
MR
Mauritania
MU
Mauritius
YT
Mayotte
MX
Mexico
FM
Micronesia
MD
Moldova
MC
Monaco
MN
Mongolia
ME
Montenegro
MS
Montserrat
MA
Morocco
MZ
Mozambique
MM
Myanmar (Burma)
NA
Namibia
NR
Nauru
NP
Nepal
NL
Netherlands
AN
Netherlands Antilles
NC
New Caledonia
NZ
New Zealand
NI
Nicaragua
NE
Niger
NG
Nigeria
NU
Niue
NF
Norfolk Island
MP
Northern Mariana Islands
KP
North Korea
NO
Norway
OM
Oman
PK
Pakistan
PW
Palau
PS
Palestinian Territories
PA
Panama
PG
Papua New Guinea
PY
Paraguay
PE
Peru
PH
Philippines
PN
Pitcairn Islands
PL
Poland
PT
Portugal
QA
Qatar
RE
Réunion
RO
Romania
RU
Russia
RW
Rwanda
WS
Samoa
SM
San Marino
ST
São Tomé & Príncipe
SA
Saudi Arabia
SN
Senegal
RS
Serbia
SC
Seychelles
SL
Sierra Leone
SG
Singapore
SK
Slovakia
SI
Slovenia
SB
Solomon Islands
SO
Somalia
ZA
South Africa
GS
South Georgia & South Sandwich Islands
KR
South Korea
ES
Spain
LK
Sri Lanka
BL
St. Barthélemy
SH
St. Helena
KN
St. Kitts & Nevis
LC
St. Lucia
MF
St. Martin
PM
St. Pierre & Miquelon
VC
St. Vincent & Grenadines
SD
Sudan
SR
Suriname
SJ
Svalbard & Jan Mayen
SE
Sweden
CH
Switzerland
SY
Syria
TW
Taiwan
TJ
Tajikistan
TZ
Tanzania
TH
Thailand
TL
Timor-Leste
TG
Togo
TK
Tokelau
TO
Tonga
TT
Trinidad & Tobago
TN
Tunisia
TR
Turkey
TM
Turkmenistan
TC
Turks & Caicos Islands
TV
Tuvalu
UG
Uganda
UA
Ukraine
AE
United Arab Emirates
GB
United Kingdom
US
United States
UY
Uruguay
UM
U.S. Outlying Islands
VI
U.S. Virgin Islands
UZ
Uzbekistan
VU
Vanuatu
VA
Vatican City
VE
Venezuela
VN
Vietnam
WF
Wallis & Futuna
EH
Western Sahara
YE
Yemen
ZM
Zambia
ZW
Zimbabwe

Example

""AF""

CreateCompanyOutput

Contains the response to the request to create a company.

Fields

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

Example

{"company": Company}

CreateCompanyRoleOutput

Contains the response to the request to create a company role.

Fields

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

Example

{"role": CompanyRole}

CreateCompanyTeamOutput

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

Fields

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

Example

{"team": CompanyTeam}

CreateCompanyUserOutput

Contains the response to the request to create a company user.

Fields

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

Example

{"user": Customer}

CreateCompareListInput

Contains an array of product IDs to use for creating a compare list.

Input Fields

Input Field
Description
products - [ID]
An array of product IDs to add to the compare list.

Example

{"products": [4]}

CreateGiftRegistryInput

Defines a new gift registry.

Input Fields

Input Field
Description
dynamic_attributes - [GiftRegistryDynamicAttributeInput]
Additional attributes specified as a code-value pair.
event_name - String!
The name of the event.
gift_registry_type_uid - ID!
The ID of the selected event type.
message - String!
A message describing the event.
privacy_settings - GiftRegistryPrivacySettings!
Indicates whether the registry is PRIVATE or PUBLIC.
registrants - [AddGiftRegistryRegistrantInput]!
The list of people who receive notifications about the registry.
shipping_address - GiftRegistryShippingAddressInput
The shipping address for all gift registry items.
status - GiftRegistryStatus!
Indicates whether the registry is ACTIVE or INACTIVE.

Example

{
  "dynamic_attributes": [
    GiftRegistryDynamicAttributeInput
  ],
  "event_name": "xyz789",
  "gift_registry_type_uid": "4",
  "message": "abc123",
  "privacy_settings": "PRIVATE",
  "registrants": [AddGiftRegistryRegistrantInput],
  "shipping_address": GiftRegistryShippingAddressInput,
  "status": "ACTIVE"
}

CreateGiftRegistryOutput

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

Fields

Field Name
Description
gift_registry - GiftRegistry
The newly-created gift registry.

Example

{"gift_registry": GiftRegistry}

CreateGuestCartInput

Input Fields

Input Field
Description
cart_uid - ID
Optional client-generated ID

Example

{"cart_uid": 4}

CreateGuestCartOutput

Fields

Field Name
Description
cart - Cart
The newly created cart.

Example

{"cart": Cart}

CreatePayflowProTokenOutput

Contains the secure information used to authorize transaction. Applies to Payflow Pro and Payments Pro payment methods.

Fields

Field Name
Description
response_message - String!
The RESPMSG returned by PayPal. If the result is 0, then response_message is Approved.
result - Int!
A non-zero value if any errors occurred.
result_code - Int!
The RESULT returned by PayPal. A value of 0 indicates the transaction was approved.
secure_token - String!
A secure token generated by PayPal.
secure_token_id - String!
A secure token ID generated by PayPal.

Example

{
  "response_message": "xyz789",
  "result": 123,
  "result_code": 123,
  "secure_token": "xyz789",
  "secure_token_id": "xyz789"
}

CreatePaymentOrderInput

Contains payment order details that are used while processing the payment order

Input Fields

Input Field
Description
cartId - String!
The customer cart ID
location - PaymentLocation!
Defines the origin location for that payment request
methodCode - String!
The code for the payment method used in the order
paymentSource - String!
The identifiable payment source for the payment method
vaultIntent - Boolean
Indicates whether the payment information should be vaulted

Example

{
  "cartId": "xyz789",
  "location": "PRODUCT_DETAIL",
  "methodCode": "abc123",
  "paymentSource": "xyz789",
  "vaultIntent": false
}

CreatePaymentOrderOutput

Contains payment order details that are used while processing the payment order

Fields

Field Name
Description
amount - Float
The amount of the payment order
currency_code - String
The currency of the payment order
id - String
PayPal order ID
mp_order_id - String
The order ID generated by Payment Services
status - String
The status of the payment order

Example

{
  "amount": 123.45,
  "currency_code": "abc123",
  "id": "xyz789",
  "mp_order_id": "abc123",
  "status": "abc123"
}

CreateProductReviewInput

Defines a new product review.

Input Fields

Input Field
Description
nickname - String!
The customer's nickname. Defaults to the customer name, if logged in.
ratings - [ProductReviewRatingInput]!
The ratings details by category. For example, Price: 5 stars, Quality: 4 stars, etc.
sku - String!
The SKU of the reviewed product.
summary - String!
The summary (title) of the review.
text - String!
The review text.

Example

{
  "nickname": "abc123",
  "ratings": [ProductReviewRatingInput],
  "sku": "abc123",
  "summary": "xyz789",
  "text": "xyz789"
}

CreateProductReviewOutput

Contains the completed product review.

Fields

Field Name
Description
review - ProductReview!
Product review details.

Example

{"review": ProductReview}

CreatePurchaseOrderApprovalRuleConditionAmountInput

Specifies the amount and currency to evaluate.

Input Fields

Input Field
Description
currency - CurrencyEnum!
Purchase order approval rule condition amount currency.
value - Float!
Purchase order approval rule condition amount value.

Example

{"currency": "AFN", "value": 123.45}

CreatePurchaseOrderApprovalRuleConditionInput

Defines a set of conditions that apply to a rule.

Input Fields

Input Field
Description
amount - CreatePurchaseOrderApprovalRuleConditionAmountInput
The amount to be compared in a purchase order approval rule. This field is mutually exclusive with condition quantity.
attribute - PurchaseOrderApprovalRuleType!
The type of approval rule.
operator - PurchaseOrderApprovalRuleConditionOperator!
Defines how to evaluate an amount or quantity in a purchase order.
quantity - Int
The quantity to be compared in a purchase order approval rule. This field is mutually exclusive with condition amount.

Example

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

CreateRequisitionListInput

An input object that identifies and describes a new requisition list.

Input Fields

Input Field
Description
description - String
An optional description of the requisition list.
name - String!
The name assigned to the requisition list.

Example

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

CreateRequisitionListOutput

Output of the request to create a requisition list.

Fields

Field Name
Description
requisition_list - RequisitionList
The created requisition list.

Example

{"requisition_list": RequisitionList}

CreateWishlistInput

Defines the name and visibility of a new wish list.

Input Fields

Input Field
Description
name - String!
The name of the new wish list.
visibility - WishlistVisibilityEnum!
Indicates whether the wish list is public or private.

Example

{"name": "xyz789", "visibility": "PUBLIC"}

CreateWishlistOutput

Contains the wish list.

Fields

Field Name
Description
wishlist - Wishlist!
The newly-created wish list

Example

{"wishlist": Wishlist}

CreditCardDetailsInput

Required fields for Payflow Pro and Payments Pro credit card payments.

Input Fields

Input Field
Description
cc_exp_month - Int!
The credit card expiration month.
cc_exp_year - Int!
The credit card expiration year.
cc_last_4 - Int!
The last 4 digits of the credit card.
cc_type - String!
The credit card type.

Example

{
  "cc_exp_month": 123,
  "cc_exp_year": 987,
  "cc_last_4": 123,
  "cc_type": "abc123"
}

CreditMemo

Contains credit memo details.

Fields

Field Name
Description
comments - [SalesCommentItem]
Comments on the credit memo.
id - ID!
The unique ID for a CreditMemo object.
items - [CreditMemoItemInterface]
An array containing details about refunded items.
number - String!
The sequential credit memo number.
total - CreditMemoTotal
Details about the total refunded amount.

Example

{
  "comments": [SalesCommentItem],
  "id": 4,
  "items": [CreditMemoItemInterface],
  "number": "abc123",
  "total": CreditMemoTotal
}

CreditMemoItem

Fields

Field Name
Description
discounts - [Discount]
Details about the final discount amount for the base product, including discounts on options.
id - ID!
The unique ID for a CreditMemoItemInterface object.
order_item - OrderItemInterface
The order item the credit memo is applied to.
product_name - String
The name of the base product.
product_sale_price - Money!
The sale price for the base product, including selected options.
product_sku - String!
The SKU of the base product.
quantity_refunded - Float
The number of refunded items.

Example

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

CreditMemoItemInterface

Credit memo item details.

Fields

Field Name
Description
discounts - [Discount]
Details about the final discount amount for the base product, including discounts on options.
id - ID!
The unique ID for a CreditMemoItemInterface object.
order_item - OrderItemInterface
The order item the credit memo is applied to.
product_name - String
The name of the base product.
product_sale_price - Money!
The sale price for the base product, including selected options.
product_sku - String!
The SKU of the base product.
quantity_refunded - Float
The number of refunded items.

Possible Types

Example

{
  "discounts": [Discount],
  "id": "4",
  "order_item": OrderItemInterface,
  "product_name": "xyz789",
  "product_sale_price": Money,
  "product_sku": "abc123",
  "quantity_refunded": 987.65
}

CreditMemoTotal

Contains credit memo price details.

Fields

Field Name
Description
adjustment - Money!
An adjustment manually applied to the order.
base_grand_total - Money!
The final base grand total amount in the base currency.
discounts - [Discount]
The applied discounts to the credit memo.
grand_total - Money!
The final total amount, including shipping, discounts, and taxes.
shipping_handling - ShippingHandling
Details about the shipping and handling costs for the credit memo.
subtotal - Money!
The subtotal of the invoice, excluding shipping, discounts, and taxes.
taxes - [TaxItem]
The credit memo tax details.
total_shipping - Money!
The shipping amount for the credit memo.
total_tax - Money!
The amount of tax applied to the credit memo.

Example

{
  "adjustment": Money,
  "base_grand_total": Money,
  "discounts": [Discount],
  "grand_total": Money,
  "shipping_handling": ShippingHandling,
  "subtotal": Money,
  "taxes": [TaxItem],
  "total_shipping": Money,
  "total_tax": Money
}

Currency

Fields

Field Name
Description
available_currency_codes - [String]
An array of three-letter currency codes accepted by the store, such as USD and EUR.
base_currency_code - String
The base currency set for the store, such as USD.
base_currency_symbol - String
The symbol for the specified base currency, such as $.
default_display_currecy_code - String
(Deprecated: Symbol was missed. Use default_display_currency_code.)
default_display_currecy_symbol - String
(Deprecated: Symbol was missed. Use default_display_currency_code.)
default_display_currency_code - String
The currency that is displayed by default, such as USD.
default_display_currency_symbol - String
The currency symbol that is displayed by default, such as $.
exchange_rates - [ExchangeRate]
An array of exchange rates for currencies defined in the store.

Example

{
  "available_currency_codes": ["abc123"],
  "base_currency_code": "abc123",
  "base_currency_symbol": "abc123",
  "default_display_currecy_code": "abc123",
  "default_display_currecy_symbol": "abc123",
  "default_display_currency_code": "xyz789",
  "default_display_currency_symbol": "xyz789",
  "exchange_rates": [ExchangeRate]
}

CurrencyEnum

The list of available currency codes.

Values

Enum Value
Description
AFN
ALL
AZN
DZD
AOA
ARS
AMD
AWG
AUD
BSD
BHD
BDT
BBD
BYN
BZD
BMD
BTN
BOB
BAM
BWP
BRL
GBP
BND
BGN
BUK
BIF
KHR
CAD
CVE
CZK
KYD
GQE
CLP
CNY
COP
KMF
CDF
CRC
HRK
CUP
DKK
DJF
DOP
XCD
EGP
SVC
ERN
EEK
ETB
EUR
FKP
FJD
GMD
GEK
GEL
GHS
GIP
GTQ
GNF
GYD
HTG
HNL
HKD
HUF
ISK
INR
IDR
IRR
IQD
ILS
JMD
JPY
JOD
KZT
KES
KWD
KGS
LAK
LVL
LBP
LSL
LRD
LYD
LTL
MOP
MKD
MGA
MWK
MYR
MVR
LSM
MRO
MUR
MXN
MDL
MNT
MAD
MZN
MMK
NAD
NPR
ANG
YTL
NZD
NIC
NGN
KPW
NOK
OMR
PKR
PAB
PGK
PYG
PEN
PHP
PLN
QAR
RHD
RON
RUB
RWF
SHP
STD
SAR
RSD
SCR
SLL
SGD
SKK
SBD
SOS
ZAR
KRW
LKR
SDG
SRD
SZL
SEK
CHF
SYP
TWD
TJS
TZS
THB
TOP
TTD
TND
TMM
USD
UGX
UAH
AED
UYU
UZS
VUV
VEB
VEF
VND
CHE
CHW
XOF
WST
YER
ZMK
ZWD
TRY
AZM
ROL
TRL
XPF

Example

""AFN""

CustomAttributeMetadata

Defines an array of custom attributes.

Fields

Field Name
Description
items - [Attribute]
An array of attributes.

Example

{"items": [Attribute]}

CustomAttributeMetadataInterface

An interface containing fields that define the EAV attribute.

Fields

Field Name
Description
code - ID!
The unique identifier for an attribute code. This value should be in lowercase letters without spaces.
default_value - String
Default attribute value.
entity_type - AttributeEntityTypeEnum!
The type of entity that defines the attribute.
frontend_class - String
The frontend class of the attribute.
frontend_input - AttributeFrontendInputEnum
The frontend input type of the attribute.
is_required - Boolean!
Whether the attribute value is required.
is_unique - Boolean!
Whether the attribute value must be unique.
label - String
The label assigned to the attribute.
options - [CustomAttributeOptionInterface]!
Attribute options.

Possible Types

Example

{
  "code": 4,
  "default_value": "xyz789",
  "entity_type": "CATALOG_PRODUCT",
  "frontend_class": "abc123",
  "frontend_input": "BOOLEAN",
  "is_required": false,
  "is_unique": true,
  "label": "xyz789",
  "options": [CustomAttributeOptionInterface]
}

CustomAttributeOptionInterface

Fields

Field Name
Description
is_default - Boolean!
Is the option value default.
label - String!
The label assigned to the attribute option.
value - String!
The attribute option value.

Possible Types

CustomAttributeOptionInterface Types
AttributeOptionMetadata

Example

{
  "is_default": false,
  "label": "xyz789",
  "value": "xyz789"
}

Customer

Defines the customer name, addresses, and other details.

Fields

Field Name
Description
addresses - [CustomerAddress]
An array containing the customer's shipping and billing addresses.
allow_remote_shopping_assistance - Boolean!
Indicates whether the customer has enabled remote shopping assistance.
companies - UserCompaniesOutput!
An object that contains a list of companies user is assigned to.
compare_list - CompareList
The contents of the customer's compare list.
confirmation_status - ConfirmationStatusEnum!
The customer's confirmation status.
created_at - String
Timestamp indicating when the account was created.
custom_attributes - [AttributeValueInterface]
Customer's custom attributes.
date_of_birth - String
The customer's date of birth.
default_billing - String
The ID assigned to the billing address.
default_shipping - String
The ID assigned to the shipping address.
dob - String
The customer's date of birth. (Deprecated: Use date_of_birth instead.)
email - String
The customer's email address. Required.
firstname - String
The customer's first name.
gender - Int
The customer's gender (Male - 1, Female - 2).
gift_registries - [GiftRegistry]
Details about all of the customer's gift registries.
gift_registry - GiftRegistry
Details about a specific gift registry.
group_id - Int
(Deprecated: Customer group should not be exposed in the storefront scenarios.)
id - Int
The ID assigned to the customer. (Deprecated: id is not needed as part of Customer, because on the server side, it can be identified based on the customer token used for authentication. There is no need to know customer ID on the client side.)
is_subscribed - Boolean
Indicates whether the customer is subscribed to the company's newsletter.
job_title - String
The job title of a company user.
lastname - String
The customer's family name.
middlename - String
The customer's middle name.
orders - CustomerOrders
prefix - String
An honorific, such as Dr., Mr., or Mrs.
purchase_order - PurchaseOrder
Purchase order details.
purchase_order_approval_rule - PurchaseOrderApprovalRule
Details about a single purchase order approval rule.
purchase_order_approval_rule_metadata - PurchaseOrderApprovalRuleMetadata
Purchase order approval rule metadata that can be used for rule edit form rendering.
purchase_order_approval_rules - PurchaseOrderApprovalRules
A list of purchase order approval rules visible to the customer.
purchase_orders - PurchaseOrders
A list of purchase orders visible to the customer.
purchase_orders_enabled - Boolean!
Indicates whether purchase order functionality is enabled for the current customer. Global and company-level settings are factored into the result.
requisition_lists - RequisitionLists
An object that contains the customer's requisition lists.
return - Return
Details about the specified return request from the unique ID for a Return object.
returns - Returns
Information about the customer's return requests.
reviews - ProductReviews!
Contains the customer's product reviews.
reward_points - RewardPoints
Customer reward points details.
role - CompanyRole
The role name and permissions assigned to the company user.
status - CompanyUserStatusEnum
Indicates whether the company user is ACTIVE or INACTIVE.
store_credit - CustomerStoreCredit
Store credit information applied for the logged in customer.
structure_id - ID!
ID of the company structure
suffix - String
A value such as Sr., Jr., or III.
taxvat - String
The customer's Value-added tax (VAT) number (for corporate customers).
team - CompanyTeam
The team the company user is assigned to.
telephone - String
The phone number of the company user.
wishlist - Wishlist!
Return a customer's wish lists. (Deprecated: Use Customer.wishlists or Customer.wishlist_v2 instead.)
wishlist_v2 - Wishlist
Retrieve the wish list identified by the unique ID for a Wishlist object.
wishlists - [Wishlist]!
An array of wishlists. In Magento Open Source, customers are limited to one wish list. The number of wish lists is configurable for Adobe Commerce.

Example

{
  "addresses": [CustomerAddress],
  "allow_remote_shopping_assistance": true,
  "companies": UserCompaniesOutput,
  "compare_list": CompareList,
  "confirmation_status": "ACCOUNT_CONFIRMED",
  "created_at": "xyz789",
  "custom_attributes": [AttributeValueInterface],
  "date_of_birth": "abc123",
  "default_billing": "abc123",
  "default_shipping": "abc123",
  "dob": "abc123",
  "email": "xyz789",
  "firstname": "abc123",
  "gender": 987,
  "gift_registries": [GiftRegistry],
  "gift_registry": GiftRegistry,
  "group_id": 987,
  "id": 123,
  "is_subscribed": true,
  "job_title": "xyz789",
  "lastname": "xyz789",
  "middlename": "xyz789",
  "orders": CustomerOrders,
  "prefix": "abc123",
  "purchase_order": PurchaseOrder,
  "purchase_order_approval_rule": PurchaseOrderApprovalRule,
  "purchase_order_approval_rule_metadata": PurchaseOrderApprovalRuleMetadata,
  "purchase_order_approval_rules": PurchaseOrderApprovalRules,
  "purchase_orders": PurchaseOrders,
  "purchase_orders_enabled": true,
  "requisition_lists": RequisitionLists,
  "return": Return,
  "returns": Returns,
  "reviews": ProductReviews,
  "reward_points": RewardPoints,
  "role": CompanyRole,
  "status": "ACTIVE",
  "store_credit": CustomerStoreCredit,
  "structure_id": 4,
  "suffix": "xyz789",
  "taxvat": "abc123",
  "team": CompanyTeam,
  "telephone": "abc123",
  "wishlist": Wishlist,
  "wishlist_v2": Wishlist,
  "wishlists": [Wishlist]
}

CustomerAddress

Contains detailed information about a customer's billing or shipping address.

Fields

Field Name
Description
city - String
The customer's city or town.
company - String
The customer's company.
country_code - CountryCodeEnum
The customer's country.
country_id - String
The customer's country. (Deprecated: Use country_code instead.)
custom_attributes - [CustomerAddressAttribute]
(Deprecated: Use custom_attributesV2 instead.)
custom_attributesV2 - [AttributeValueInterface]!
Custom attributes assigned to the customer address.
customer_id - Int
The customer ID (Deprecated: customer_id is not needed as part of CustomerAddress. The id is a unique identifier for the addresses.)
default_billing - Boolean
Indicates whether the address is the customer's default billing address.
default_shipping - Boolean
Indicates whether the address is the customer's default shipping address.
extension_attributes - [CustomerAddressAttribute]
Contains any extension attributes for the address.
fax - String
The customer's fax number.
firstname - String
The first name of the person associated with the shipping/billing address.
id - Int
The ID of a CustomerAddress object.
lastname - String
The family name of the person associated with the shipping/billing address.
middlename - String
The middle name of the person associated with the shipping/billing address.
postcode - String
The customer's ZIP or postal code.
prefix - String
An honorific, such as Dr., Mr., or Mrs.
region - CustomerAddressRegion
An object containing the region name, region code, and region ID.
region_id - Int
The unique ID for a pre-defined region.
street - [String]
An array of strings that define the street number and name.
suffix - String
A value such as Sr., Jr., or III.
telephone - String
The customer's telephone number.
vat_id - String
The customer's Value-added tax (VAT) number (for corporate customers).

Example

{
  "city": "abc123",
  "company": "xyz789",
  "country_code": "AF",
  "country_id": "xyz789",
  "custom_attributes": [CustomerAddressAttribute],
  "custom_attributesV2": [AttributeValueInterface],
  "customer_id": 987,
  "default_billing": false,
  "default_shipping": true,
  "extension_attributes": [CustomerAddressAttribute],
  "fax": "xyz789",
  "firstname": "abc123",
  "id": 987,
  "lastname": "xyz789",
  "middlename": "xyz789",
  "postcode": "xyz789",
  "prefix": "xyz789",
  "region": CustomerAddressRegion,
  "region_id": 987,
  "street": ["xyz789"],
  "suffix": "xyz789",
  "telephone": "xyz789",
  "vat_id": "abc123"
}

CustomerAddressAttribute

Specifies the attribute code and value of a customer address attribute.

Fields

Field Name
Description
attribute_code - String
The name assigned to the customer address attribute.
value - String
The value assigned to the customer address attribute.

Example

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

CustomerAddressAttributeInput

Specifies the attribute code and value of a customer attribute.

Input Fields

Input Field
Description
attribute_code - String!
The name assigned to the attribute.
value - String!
The value assigned to the attribute.

Example

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

CustomerAddressInput

Contains details about a billing or shipping address.

Input Fields

Input Field
Description
city - String
The customer's city or town.
company - String
The customer's company.
country_code - CountryCodeEnum
The two-letter code representing the customer's country.
country_id - CountryCodeEnum
Deprecated: use country_code instead.
custom_attributes - [CustomerAddressAttributeInput]
Deprecated. Use custom_attributesV2 instead.
custom_attributesV2 - [AttributeValueInput]
Custom attributes assigned to the customer address.
default_billing - Boolean
Indicates whether the address is the default billing address.
default_shipping - Boolean
Indicates whether the address is the default shipping address.
fax - String
The customer's fax number.
firstname - String
The first name of the person associated with the billing/shipping address.
lastname - String
The family name of the person associated with the billing/shipping address.
middlename - String
The middle name of the person associated with the billing/shipping address.
postcode - String
The customer's ZIP or postal code.
prefix - String
An honorific, such as Dr., Mr., or Mrs.
region - CustomerAddressRegionInput
An object containing the region name, region code, and region ID.
street - [String]
An array of strings that define the street number and name.
suffix - String
A value such as Sr., Jr., or III.
telephone - String
The customer's telephone number.
vat_id - String
The customer's Tax/VAT number (for corporate customers).

Example

{
  "city": "abc123",
  "company": "xyz789",
  "country_code": "AF",
  "country_id": "AF",
  "custom_attributes": [CustomerAddressAttributeInput],
  "custom_attributesV2": [AttributeValueInput],
  "default_billing": true,
  "default_shipping": true,
  "fax": "xyz789",
  "firstname": "abc123",
  "lastname": "xyz789",
  "middlename": "abc123",
  "postcode": "xyz789",
  "prefix": "abc123",
  "region": CustomerAddressRegionInput,
  "street": ["abc123"],
  "suffix": "xyz789",
  "telephone": "abc123",
  "vat_id": "abc123"
}

CustomerAddressRegion

Defines the customer's state or province.

Fields

Field Name
Description
region - String
The state or province name.
region_code - String
The address region code.
region_id - Int
The unique ID for a pre-defined region.

Example

{
  "region": "abc123",
  "region_code": "abc123",
  "region_id": 123
}

CustomerAddressRegionInput

Defines the customer's state or province.

Input Fields

Input Field
Description
region - String
The state or province name.
region_code - String
The address region code.
region_id - Int
The unique ID for a pre-defined region.

Example

{
  "region": "abc123",
  "region_code": "abc123",
  "region_id": 987
}

CustomerAttributeMetadata

Customer attribute metadata.

Fields

Field Name
Description
code - ID!
The unique identifier for an attribute code. This value should be in lowercase letters without spaces.
default_value - String
Default attribute value.
entity_type - AttributeEntityTypeEnum!
The type of entity that defines the attribute.
frontend_class - String
The frontend class of the attribute.
frontend_input - AttributeFrontendInputEnum
The frontend input type of the attribute.
input_filter - InputFilterEnum
The template used for the input of the attribute (e.g., 'date').
is_required - Boolean!
Whether the attribute value is required.
is_unique - Boolean!
Whether the attribute value must be unique.
label - String
The label assigned to the attribute.
multiline_count - Int
The number of lines of the attribute value.
options - [CustomAttributeOptionInterface]!
Attribute options.
sort_order - Int
The position of the attribute in the form.
validate_rules - [ValidationRule]
The validation rules of the attribute value.

Example

{
  "code": 4,
  "default_value": "abc123",
  "entity_type": "CATALOG_PRODUCT",
  "frontend_class": "abc123",
  "frontend_input": "BOOLEAN",
  "input_filter": "NONE",
  "is_required": false,
  "is_unique": true,
  "label": "abc123",
  "multiline_count": 987,
  "options": [CustomAttributeOptionInterface],
  "sort_order": 123,
  "validate_rules": [ValidationRule]
}

CustomerCreateInput

An input object for creating a customer.

Input Fields

Input Field
Description
allow_remote_shopping_assistance - Boolean
Indicates whether the customer has enabled remote shopping assistance.
custom_attributes - [AttributeValueInput]
The customer's custom attributes.
date_of_birth - String
The customer's date of birth.
dob - String
Deprecated: Use date_of_birth instead.
email - String!
The customer's email address.
firstname - String!
The customer's first name.
gender - Int
The customer's gender (Male - 1, Female - 2).
is_subscribed - Boolean
Indicates whether the customer is subscribed to the company's newsletter.
lastname - String!
The customer's family name.
middlename - String
The customer's middle name.
password - String
The customer's password.
prefix - String
An honorific, such as Dr., Mr., or Mrs.
suffix - String
A value such as Sr., Jr., or III.
taxvat - String
The customer's Tax/VAT number (for corporate customers).

Example

{
  "allow_remote_shopping_assistance": false,
  "custom_attributes": [AttributeValueInput],
  "date_of_birth": "abc123",
  "dob": "xyz789",
  "email": "xyz789",
  "firstname": "abc123",
  "gender": 123,
  "is_subscribed": true,
  "lastname": "abc123",
  "middlename": "xyz789",
  "password": "abc123",
  "prefix": "xyz789",
  "suffix": "xyz789",
  "taxvat": "xyz789"
}

CustomerDownloadableProduct

Contains details about a single downloadable product.

Fields

Field Name
Description
date - String
The date and time the purchase was made.
download_url - String
The fully qualified URL to the download file.
order_increment_id - String
The unique ID assigned to the item.
remaining_downloads - String
The remaining number of times the customer can download the product.
status - String
Indicates when the product becomes available for download. Options are Pending and Invoiced.

Example

{
  "date": "xyz789",
  "download_url": "abc123",
  "order_increment_id": "abc123",
  "remaining_downloads": "abc123",
  "status": "xyz789"
}

CustomerDownloadableProducts

Contains a list of downloadable products.

Fields

Field Name
Description
items - [CustomerDownloadableProduct]
An array of purchased downloadable items.

Example

{"items": [CustomerDownloadableProduct]}

CustomerInput

An input object that assigns or updates customer attributes.

Input Fields

Input Field
Description
date_of_birth - String
The customer's date of birth.
dob - String
Deprecated: Use date_of_birth instead.
email - String
The customer's email address. Required when creating a customer.
firstname - String
The customer's first name.
gender - Int
The customer's gender (Male - 1, Female - 2).
is_subscribed - Boolean
Indicates whether the customer is subscribed to the company's newsletter.
lastname - String
The customer's family name.
middlename - String
The customer's middle name.
password - String
The customer's password.
prefix - String
An honorific, such as Dr., Mr., or Mrs.
suffix - String
A value such as Sr., Jr., or III.
taxvat - String
The customer's Tax/VAT number (for corporate customers).

Example

{
  "date_of_birth": "abc123",
  "dob": "xyz789",
  "email": "xyz789",
  "firstname": "xyz789",
  "gender": 123,
  "is_subscribed": true,
  "lastname": "abc123",
  "middlename": "xyz789",
  "password": "abc123",
  "prefix": "abc123",
  "suffix": "xyz789",
  "taxvat": "xyz789"
}

CustomerOrder

Contains details about each of the customer's orders.

Fields

Field Name
Description
applied_coupons - [AppliedCoupon]!
Coupons applied to the order.
billing_address - OrderAddress
The billing address for the order.
carrier - String
The shipping carrier for the order delivery.
comments - [SalesCommentItem]
Comments about the order.
created_at - String
(Deprecated: Use the order_date field instead.)
credit_memos - [CreditMemo]
A list of credit memos.
email - String
Order customer email.
gift_message - GiftMessage
The entered gift message for the order
gift_receipt_included - Boolean!
Indicates whether the customer requested a gift receipt for the order.
gift_wrapping - GiftWrapping
The selected gift wrapping for the order.
grand_total - Float
(Deprecated: Use the totals.grand_total field instead.)
id - ID!
The unique ID for a CustomerOrder object.
increment_id - String
(Deprecated: Use the id field instead.)
invoices - [Invoice]!
A list of invoices for the order.
items - [OrderItemInterface]
An array containing the items purchased in this order.
items_eligible_for_return - [OrderItemInterface]
A list of order items eligible to be in a return request.
number - String!
The order number.
order_date - String!
The date the order was placed.
order_number - String!
(Deprecated: Use the number field instead.)
payment_methods - [OrderPaymentMethod]
Payment details for the order.
printed_card_included - Boolean!
Indicates whether the customer requested a printed card for the order.
returns - Returns
Return requests associated with this order.
shipments - [OrderShipment]
A list of shipments for the order.
shipping_address - OrderAddress
The shipping address for the order.
shipping_method - String
The delivery method for the order.
status - String!
The current status of the order.
token - String!
The token that can be used to retrieve the order using order query.
total - OrderTotal
Details about the calculated totals for this order.

Example

{
  "applied_coupons": [AppliedCoupon],
  "billing_address": OrderAddress,
  "carrier": "abc123",
  "comments": [SalesCommentItem],
  "created_at": "abc123",
  "credit_memos": [CreditMemo],
  "email": "xyz789",
  "gift_message": GiftMessage,
  "gift_receipt_included": false,
  "gift_wrapping": GiftWrapping,
  "grand_total": 987.65,
  "id": 4,
  "increment_id": "abc123",
  "invoices": [Invoice],
  "items": [OrderItemInterface],
  "items_eligible_for_return": [OrderItemInterface],
  "number": "abc123",
  "order_date": "xyz789",
  "order_number": "xyz789",
  "payment_methods": [OrderPaymentMethod],
  "printed_card_included": true,
  "returns": Returns,
  "shipments": [OrderShipment],
  "shipping_address": OrderAddress,
  "shipping_method": "xyz789",
  "status": "xyz789",
  "token": "abc123",
  "total": OrderTotal
}

CustomerOrderSortInput

CustomerOrderSortInput specifies the field to use for sorting search results and indicates whether the results are sorted in ascending or descending order.

Input Fields

Input Field
Description
sort_direction - SortEnum!
This enumeration indicates whether to return results in ascending or descending order
sort_field - CustomerOrderSortableField!
Specifies the field to use for sorting

Example

{"sort_direction": "ASC", "sort_field": "NUMBER"}

CustomerOrderSortableField

Specifies the field to use for sorting

Values

Enum Value
Description
NUMBER
Sorts customer orders by number
CREATED_AT
Sorts customer orders by created_at field

Example

""NUMBER""

CustomerOrders

The collection of orders that match the conditions defined in the filter.

Fields

Field Name
Description
items - [CustomerOrder]!
An array of customer orders.
page_info - SearchResultPageInfo
Contains pagination metadata.
total_count - Int
The total count of customer orders.

Example

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

CustomerOrdersFilterInput

Identifies the filter to use for filtering orders.

Input Fields

Input Field
Description
number - FilterStringTypeInput
Filters by order number.

Example

{"number": FilterStringTypeInput}

CustomerOutput

Contains details about a newly-created or updated customer.

Fields

Field Name
Description
customer - Customer!
Customer details after creating or updating a customer.

Example

{"customer": Customer}

CustomerPaymentTokens

Contains payment tokens stored in the customer's vault.

Fields

Field Name
Description
items - [PaymentToken]!
An array of payment tokens.

Example

{"items": [PaymentToken]}

CustomerStoreCredit

Contains store credit information with balance and history.

Fields

Field Name
Description
balance_history - CustomerStoreCreditHistory
Contains the customer's store credit balance history. If the history or store credit feature is disabled, then a null value will be returned.
current_balance - Money
The current balance of store credit.
enabled - Boolean
Indicates whether store credits are enabled. If the feature is disabled, then the balance will not be returned.

Example

{
  "balance_history": CustomerStoreCreditHistory,
  "current_balance": Money,
  "enabled": true
}

CustomerStoreCreditHistory

Lists changes to the amount of store credit available to the customer.

Fields

Field Name
Description
items - [CustomerStoreCreditHistoryItem]
An array containing information about changes to the store credit available to the customer.
page_info - SearchResultPageInfo
Metadata for pagination rendering.
total_count - Int
The number of items returned.

Example

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

CustomerStoreCreditHistoryItem

Contains store credit history information.

Fields

Field Name
Description
action - String
The action that was made on the store credit.
actual_balance - Money
The store credit available to the customer as a result of this action.
balance_change - Money
The amount added to or subtracted from the store credit as a result of this action.
date_time_changed - String
The date and time when the store credit change was made.

Example

{
  "action": "xyz789",
  "actual_balance": Money,
  "balance_change": Money,
  "date_time_changed": "abc123"
}

CustomerToken

Contains a customer authorization token.

Fields

Field Name
Description
token - String
The customer authorization token.

Example

{"token": "abc123"}

CustomerUpdateInput

An input object for updating a customer.

Input Fields

Input Field
Description
allow_remote_shopping_assistance - Boolean
Indicates whether the customer has enabled remote shopping assistance.
custom_attributes - [AttributeValueInput]
The customer's custom attributes.
date_of_birth - String
The customer's date of birth.
dob - String
Deprecated: Use date_of_birth instead.
firstname - String
The customer's first name.
gender - Int
The customer's gender (Male - 1, Female - 2).
is_subscribed - Boolean
Indicates whether the customer is subscribed to the company's newsletter.
lastname - String
The customer's family name.
middlename - String
The customer's middle name.
prefix - String
An honorific, such as Dr., Mr., or Mrs.
suffix - String
A value such as Sr., Jr., or III.
taxvat - String
The customer's Tax/VAT number (for corporate customers).

Example

{
  "allow_remote_shopping_assistance": true,
  "custom_attributes": [AttributeValueInput],
  "date_of_birth": "xyz789",
  "dob": "abc123",
  "firstname": "abc123",
  "gender": 987,
  "is_subscribed": true,
  "lastname": "xyz789",
  "middlename": "abc123",
  "prefix": "xyz789",
  "suffix": "abc123",
  "taxvat": "abc123"
}

CustomizableAreaOption

Contains information about a text area that is defined as part of a customizable option.

Fields

Field Name
Description
option_id - Int
Option ID. (Deprecated: Use uid instead)
product_sku - String
The Stock Keeping Unit of the base product.
required - Boolean
Indicates whether the option is required.
sort_order - Int
The order in which the option is displayed.
title - String
The display name for this option.
uid - ID!
The unique ID for a CustomizableOptionInterface object.
value - CustomizableAreaValue
An object that defines a text area.

Example

{
  "option_id": 987,
  "product_sku": "xyz789",
  "required": false,
  "sort_order": 987,
  "title": "xyz789",
  "uid": 4,
  "value": CustomizableAreaValue
}

CustomizableAreaValue

Defines the price and sku of a product whose page contains a customized text area.

Fields

Field Name
Description
max_characters - Int
The maximum number of characters that can be entered for this customizable option.
price - Float
The price assigned to this option.
price_type - PriceTypeEnum
FIXED, PERCENT, or DYNAMIC.
sku - String
The Stock Keeping Unit for this option.
uid - ID!
The unique ID for a CustomizableAreaValue object.

Example

{
  "max_characters": 123,
  "price": 987.65,
  "price_type": "FIXED",
  "sku": "xyz789",
  "uid": 4
}

CustomizableCheckboxOption

Contains information about a set of checkbox values that are defined as part of a customizable option.

Fields

Field Name
Description
option_id - Int
Option ID. (Deprecated: Use uid instead)
required - Boolean
Indicates whether the option is required.
sort_order - Int
The order in which the option is displayed.
title - String
The display name for this option.
uid - ID!
The unique ID for a CustomizableOptionInterface object.
value - [CustomizableCheckboxValue]
An array that defines a set of checkbox values.

Example

{
  "option_id": 123,
  "required": true,
  "sort_order": 987,
  "title": "xyz789",
  "uid": "4",
  "value": [CustomizableCheckboxValue]
}

CustomizableCheckboxValue

Defines the price and sku of a product whose page contains a customized set of checkbox values.

Fields

Field Name
Description
option_type_id - Int
The ID assigned to the value.
price - Float
The price assigned to this option.
price_type - PriceTypeEnum
FIXED, PERCENT, or DYNAMIC.
sku - String
The Stock Keeping Unit for this option.
sort_order - Int
The order in which the checkbox value is displayed.
title - String
The display name for this option.
uid - ID!
The unique ID for a CustomizableCheckboxValue object.

Example

{
  "option_type_id": 123,
  "price": 987.65,
  "price_type": "FIXED",
  "sku": "xyz789",
  "sort_order": 123,
  "title": "xyz789",
  "uid": 4
}

CustomizableDateOption

Contains information about a date picker that is defined as part of a customizable option.

Fields

Field Name
Description
option_id - Int
Option ID. (Deprecated: Use uid instead)
product_sku - String
The Stock Keeping Unit of the base product.
required - Boolean
Indicates whether the option is required.
sort_order - Int
The order in which the option is displayed.
title - String
The display name for this option.
uid - ID!
The unique ID for a CustomizableOptionInterface object.
value - CustomizableDateValue
An object that defines a date field in a customizable option.

Example

{
  "option_id": 123,
  "product_sku": "abc123",
  "required": false,
  "sort_order": 987,
  "title": "abc123",
  "uid": "4",
  "value": CustomizableDateValue
}

CustomizableDateTypeEnum

Defines the customizable date type.

Values

Enum Value
Description
DATE
DATE_TIME
TIME

Example

""DATE""

CustomizableDateValue

Defines the price and sku of a product whose page contains a customized date picker.

Fields

Field Name
Description
price - Float
The price assigned to this option.
price_type - PriceTypeEnum
FIXED, PERCENT, or DYNAMIC.
sku - String
The Stock Keeping Unit for this option.
type - CustomizableDateTypeEnum
DATE, DATE_TIME or TIME
uid - ID!
The unique ID for a CustomizableDateValue object.

Example

{
  "price": 987.65,
  "price_type": "FIXED",
  "sku": "xyz789",
  "type": "DATE",
  "uid": "4"
}

CustomizableDropDownOption

Contains information about a drop down menu that is defined as part of a customizable option.

Fields

Field Name
Description
option_id - Int
Option ID. (Deprecated: Use uid instead)
required - Boolean
Indicates whether the option is required.
sort_order - Int
The order in which the option is displayed.
title - String
The display name for this option.
uid - ID!
The unique ID for a CustomizableOptionInterface object.
value - [CustomizableDropDownValue]
An array that defines the set of options for a drop down menu.

Example

{
  "option_id": 987,
  "required": false,
  "sort_order": 123,
  "title": "abc123",
  "uid": 4,
  "value": [CustomizableDropDownValue]
}

CustomizableDropDownValue

Defines the price and sku of a product whose page contains a customized drop down menu.

Fields

Field Name
Description
option_type_id - Int
The ID assigned to the value.
price - Float
The price assigned to this option.
price_type - PriceTypeEnum
FIXED, PERCENT, or DYNAMIC.
sku - String
The Stock Keeping Unit for this option.
sort_order - Int
The order in which the option is displayed.
title - String
The display name for this option.
uid - ID!
The unique ID for a CustomizableDropDownValue object.

Example

{
  "option_type_id": 123,
  "price": 987.65,
  "price_type": "FIXED",
  "sku": "abc123",
  "sort_order": 987,
  "title": "abc123",
  "uid": "4"
}

CustomizableFieldOption

Contains information about a text field that is defined as part of a customizable option.

Fields

Field Name
Description
option_id - Int
Option ID. (Deprecated: Use uid instead)
product_sku - String
The Stock Keeping Unit of the base product.
required - Boolean
Indicates whether the option is required.
sort_order - Int
The order in which the option is displayed.
title - String
The display name for this option.
uid - ID!
The unique ID for a CustomizableOptionInterface object.
value - CustomizableFieldValue
An object that defines a text field.

Example

{
  "option_id": 987,
  "product_sku": "xyz789",
  "required": false,
  "sort_order": 123,
  "title": "xyz789",
  "uid": 4,
  "value": CustomizableFieldValue
}

CustomizableFieldValue

Defines the price and sku of a product whose page contains a customized text field.

Fields

Field Name
Description
max_characters - Int
The maximum number of characters that can be entered for this customizable option.
price - Float
The price of the custom value.
price_type - PriceTypeEnum
FIXED, PERCENT, or DYNAMIC.
sku - String
The Stock Keeping Unit for this option.
uid - ID!
The unique ID for a CustomizableFieldValue object.

Example

{
  "max_characters": 987,
  "price": 123.45,
  "price_type": "FIXED",
  "sku": "abc123",
  "uid": "4"
}

CustomizableFileOption

Contains information about a file picker that is defined as part of a customizable option.

Fields

Field Name
Description
option_id - Int
Option ID. (Deprecated: Use uid instead)
product_sku - String
The Stock Keeping Unit of the base product.
required - Boolean
Indicates whether the option is required.
sort_order - Int
The order in which the option is displayed.
title - String
The display name for this option.
uid - ID!
The unique ID for a CustomizableOptionInterface object.
value - CustomizableFileValue
An object that defines a file value.

Example

{
  "option_id": 987,
  "product_sku": "xyz789",
  "required": true,
  "sort_order": 123,
  "title": "xyz789",
  "uid": "4",
  "value": CustomizableFileValue
}

CustomizableFileValue

Defines the price and sku of a product whose page contains a customized file picker.

Fields

Field Name
Description
file_extension - String
The file extension to accept.
image_size_x - Int
The maximum width of an image.
image_size_y - Int
The maximum height of an image.
price - Float
The price assigned to this option.
price_type - PriceTypeEnum
FIXED, PERCENT, or DYNAMIC.
sku - String
The Stock Keeping Unit for this option.
uid - ID!
The unique ID for a CustomizableFileValue object.

Example

{
  "file_extension": "xyz789",
  "image_size_x": 987,
  "image_size_y": 123,
  "price": 123.45,
  "price_type": "FIXED",
  "sku": "abc123",
  "uid": "4"
}

CustomizableMultipleOption

Contains information about a multiselect that is defined as part of a customizable option.

Fields

Field Name
Description
option_id - Int
Option ID. (Deprecated: Use uid instead)
required - Boolean
Indicates whether the option is required.
sort_order - Int
The order in which the option is displayed.
title - String
The display name for this option.
uid - ID!
The unique ID for a CustomizableOptionInterface object.
value - [CustomizableMultipleValue]
An array that defines the set of options for a multiselect.

Example

{
  "option_id": 123,
  "required": true,
  "sort_order": 123,
  "title": "abc123",
  "uid": 4,
  "value": [CustomizableMultipleValue]
}

CustomizableMultipleValue

Defines the price and sku of a product whose page contains a customized multiselect.

Fields

Field Name
Description
option_type_id - Int
The ID assigned to the value.
price - Float
The price assigned to this option.
price_type - PriceTypeEnum
FIXED, PERCENT, or DYNAMIC.
sku - String
The Stock Keeping Unit for this option.
sort_order - Int
The order in which the option is displayed.
title - String
The display name for this option.
uid - ID!
The unique ID for a CustomizableMultipleValue object.

Example

{
  "option_type_id": 987,
  "price": 987.65,
  "price_type": "FIXED",
  "sku": "abc123",
  "sort_order": 987,
  "title": "abc123",
  "uid": 4
}

CustomizableOptionInput

Defines a customizable option.

Input Fields

Input Field
Description
id - Int
The customizable option ID of the product.
uid - ID
The unique ID for a CartItemInterface object.
value_string - String!
The string value of the option.

Example

{
  "id": 123,
  "uid": 4,
  "value_string": "xyz789"
}

CustomizableOptionInterface

Contains basic information about a customizable option. It can be implemented by several types of configurable options.

Fields

Field Name
Description
option_id - Int
Option ID. (Deprecated: Use uid instead)
required - Boolean
Indicates whether the option is required.
sort_order - Int
The order in which the option is displayed.
title - String
The display name for this option.
uid - ID!
The unique ID for a CustomizableOptionInterface object.

Possible Types

Example

{
  "option_id": 123,
  "required": true,
  "sort_order": 123,
  "title": "abc123",
  "uid": "4"
}

CustomizableProductInterface

Contains information about customizable product options.

Fields

Field Name
Description
options - [CustomizableOptionInterface]
An array of options for a customizable product.

Possible Types

Example

{"options": [CustomizableOptionInterface]}

CustomizableRadioOption

Contains information about a set of radio buttons that are defined as part of a customizable option.

Fields

Field Name
Description
option_id - Int
Option ID. (Deprecated: Use uid instead)
required - Boolean
Indicates whether the option is required.
sort_order - Int
The order in which the option is displayed.
title - String
The display name for this option.
uid - ID!
The unique ID for a CustomizableOptionInterface object.
value - [CustomizableRadioValue]
An array that defines a set of radio buttons.

Example

{
  "option_id": 123,
  "required": false,
  "sort_order": 123,
  "title": "abc123",
  "uid": 4,
  "value": [CustomizableRadioValue]
}

CustomizableRadioValue

Defines the price and sku of a product whose page contains a customized set of radio buttons.

Fields

Field Name
Description
option_type_id - Int
The ID assigned to the value.
price - Float
The price assigned to this option.
price_type - PriceTypeEnum
FIXED, PERCENT, or DYNAMIC.
sku - String
The Stock Keeping Unit for this option.
sort_order - Int
The order in which the radio button is displayed.
title - String
The display name for this option.
uid - ID!
The unique ID for a CustomizableRadioValue object.

Example

{
  "option_type_id": 987,
  "price": 987.65,
  "price_type": "FIXED",
  "sku": "abc123",
  "sort_order": 123,
  "title": "abc123",
  "uid": 4
}

DeleteCompanyRoleOutput

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

Fields

Field Name
Description
success - Boolean!
SIndicates whether the company role has been deleted successfully.

Example

{"success": true}

DeleteCompanyTeamOutput

Contains the status of the request to delete a company team.

Fields

Field Name
Description
success - Boolean!
Indicates whether the delete operation succeeded.

Example

{"success": false}

DeleteCompanyUserOutput

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

Fields

Field Name
Description
success - Boolean!
Indicates whether the company user has been deactivated successfully.

Example

{"success": true}

DeleteCompareListOutput

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

Fields

Field Name
Description
result - Boolean!
Indicates whether the compare list was successfully deleted.

Example

{"result": true}

DeleteNegotiableQuoteError

Types

Example

NegotiableQuoteInvalidStateError

DeleteNegotiableQuoteOperationFailure

Contains details about a failed delete operation on a negotiable quote.

Fields

Field Name
Description
errors - [DeleteNegotiableQuoteError]!
quote_uid - ID!
The unique ID of a NegotiableQuote object.

Example

{
  "errors": [NegotiableQuoteInvalidStateError],
  "quote_uid": 4
}

DeleteNegotiableQuoteOperationResult

Types

Example

NegotiableQuoteUidOperationSuccess

DeleteNegotiableQuoteTemplateInput

Specifies the quote template id of the quote template to delete

Input Fields

Input Field
Description
template_id - ID!
The unique ID of a NegotiableQuoteTemplate object.

Example

{"template_id": "4"}

DeleteNegotiableQuotesInput

Input Fields

Input Field
Description
quote_uids - [ID]!
A list of unique IDs for NegotiableQuote objects to delete.

Example

{"quote_uids": ["4"]}

DeleteNegotiableQuotesOutput

Contains a list of undeleted negotiable quotes the company user can view.

Fields

Field Name
Description
negotiable_quotes - NegotiableQuotesOutput
A list of negotiable quotes that the customer can view
operation_results - [DeleteNegotiableQuoteOperationResult]!
An array of deleted negotiable quote UIDs and details about any errors.
result_status - BatchMutationStatus!
The status of the request to delete one or more negotiable quotes.

Example

{
  "negotiable_quotes": NegotiableQuotesOutput,
  "operation_results": [
    NegotiableQuoteUidOperationSuccess
  ],
  "result_status": "SUCCESS"
}

DeletePaymentTokenOutput

Indicates whether the request succeeded and returns the remaining customer payment tokens.

Fields

Field Name
Description
customerPaymentTokens - CustomerPaymentTokens
A container for the customer's remaining payment tokens.
result - Boolean!
Indicates whether the request succeeded.

Example

{
  "customerPaymentTokens": CustomerPaymentTokens,
  "result": true
}

DeletePurchaseOrderApprovalRuleError

Contains details about an error that occurred when deleting an approval rule .

Fields

Field Name
Description
message - String
The text of the error message.
type - DeletePurchaseOrderApprovalRuleErrorType
The error type.

Example

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

DeletePurchaseOrderApprovalRuleErrorType

Values

Enum Value
Description
UNDEFINED
NOT_FOUND

Example

""UNDEFINED""

DeletePurchaseOrderApprovalRuleInput

Specifies the IDs of the approval rules to delete.

Input Fields

Input Field
Description
approval_rule_uids - [ID]!
An array of purchase order approval rule IDs.

Example

{"approval_rule_uids": ["4"]}

DeletePurchaseOrderApprovalRuleOutput

Contains any errors encountered while attempting to delete approval rules.

Fields

Field Name
Description
errors - [DeletePurchaseOrderApprovalRuleError]!
An array of error messages encountered while performing the operation.

Example

{"errors": [DeletePurchaseOrderApprovalRuleError]}

DeleteRequisitionListItemsOutput

Output of the request to remove items from the requisition list.

Fields

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

Example

{"requisition_list": RequisitionList}

DeleteRequisitionListOutput

Indicates whether the request to delete the requisition list was successful.

Fields

Field Name
Description
requisition_lists - RequisitionLists
The customer's requisition lists after deleting a requisition list.
status - Boolean!
Indicates whether the request to delete the requisition list was successful.

Example

{"requisition_lists": RequisitionLists, "status": false}

DeleteWishlistOutput

Contains the status of the request to delete a wish list and an array of the customer's remaining wish lists.

Fields

Field Name
Description
status - Boolean!
Indicates whether the wish list was deleted.
wishlists - [Wishlist]!
A list of undeleted wish lists.

Example

{"status": false, "wishlists": [Wishlist]}

Discount

Specifies the discount type and value for quote line item.

Fields

Field Name
Description
amount - Money!
The amount of the discount.
applied_to - CartDiscountType!
The type of the entity the discount is applied to.
coupon - AppliedCoupon
The coupon related to the discount.
is_discounting_locked - Boolean
Is quote discounting locked for line item.
label - String!
A description of the discount.
type - String
Quote line item discount type. Values: 1 = PERCENTAGE_DISCOUNT; 2 = AMOUNT_DISCOUNT; 3 = PROPOSED_TOTAL.
value - Float
Quote line item discount value.

Example

{
  "amount": Money,
  "applied_to": "ITEM",
  "coupon": AppliedCoupon,
  "is_discounting_locked": true,
  "label": "xyz789",
  "type": "abc123",
  "value": 123.45
}

DownloadableCartItem

An implementation for downloadable product cart items.

Fields

Field Name
Description
customizable_options - [SelectedCustomizableOption]!
An array containing the customizable options the shopper selected.
discount - [Discount]
Contains discount for quote line item.
errors - [CartItemError]
An array of errors encountered while loading the cart item
id - String!
(Deprecated: Use uid instead.)
is_available - Boolean!
True if requested quantity is less than available stock, false otherwise.
links - [DownloadableProductLinks]
An array containing information about the links for the downloadable product added to the cart.
max_qty - Float
Line item max qty in quote template
min_qty - Float
Line item min qty in quote template
note_from_buyer - [ItemNote]
The buyer's quote line item note.
note_from_seller - [ItemNote]
The seller's quote line item note.
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.
samples - [DownloadableProductSamples]
An array containing information about samples of the selected downloadable product.
uid - ID!
The unique ID for a CartItemInterface object.

Example

{
  "customizable_options": [SelectedCustomizableOption],
  "discount": [Discount],
  "errors": [CartItemError],
  "id": "abc123",
  "is_available": false,
  "links": [DownloadableProductLinks],
  "max_qty": 123.45,
  "min_qty": 987.65,
  "note_from_buyer": [ItemNote],
  "note_from_seller": [ItemNote],
  "prices": CartItemPrices,
  "product": ProductInterface,
  "quantity": 987.65,
  "samples": [DownloadableProductSamples],
  "uid": "4"
}

DownloadableCreditMemoItem

Defines downloadable product options for CreditMemoItemInterface.

Fields

Field Name
Description
discounts - [Discount]
Details about the final discount amount for the base product, including discounts on options.
downloadable_links - [DownloadableItemsLinks]
A list of downloadable links that are refunded from the downloadable product.
id - ID!
The unique ID for a CreditMemoItemInterface object.
order_item - OrderItemInterface
The order item the credit memo is applied to.
product_name - String
The name of the base product.
product_sale_price - Money!
The sale price for the base product, including selected options.
product_sku - String!
The SKU of the base product.
quantity_refunded - Float
The number of refunded items.

Example

{
  "discounts": [Discount],
  "downloadable_links": [DownloadableItemsLinks],
  "id": 4,
  "order_item": OrderItemInterface,
  "product_name": "abc123",
  "product_sale_price": Money,
  "product_sku": "xyz789",
  "quantity_refunded": 987.65
}

DownloadableFileTypeEnum

Values

Enum Value
Description
FILE
(Deprecated: sample_url serves to get the downloadable sample)
URL
(Deprecated: sample_url serves to get the downloadable sample)

Example

""FILE""

DownloadableInvoiceItem

Defines downloadable product options for InvoiceItemInterface.

Fields

Field Name
Description
discounts - [Discount]
Information about the final discount amount for the base product, including discounts on options.
downloadable_links - [DownloadableItemsLinks]
A list of downloadable links that are invoiced from the downloadable product.
id - ID!
The unique ID for an InvoiceItemInterface object.
order_item - OrderItemInterface
Details about an individual order item.
product_name - String
The name of the base product.
product_sale_price - Money!
The sale price for the base product including selected options.
product_sku - String!
The SKU of the base product.
quantity_invoiced - Float
The number of invoiced items.

Example

{
  "discounts": [Discount],
  "downloadable_links": [DownloadableItemsLinks],
  "id": "4",
  "order_item": OrderItemInterface,
  "product_name": "xyz789",
  "product_sale_price": Money,
  "product_sku": "abc123",
  "quantity_invoiced": 123.45
}

Defines characteristics of the links for downloadable product.

Fields

Field Name
Description
sort_order - Int
A number indicating the sort order.
title - String
The display name of the link.
uid - ID!
The unique ID for a DownloadableItemsLinks object.

Example

{
  "sort_order": 123,
  "title": "abc123",
  "uid": "4"
}

DownloadableOrderItem

Defines downloadable product options for OrderItemInterface.

Fields

Field Name
Description
discounts - [Discount]
The final discount information for the product.
downloadable_links - [DownloadableItemsLinks]
A list of downloadable links that are ordered from the downloadable product.
eligible_for_return - Boolean
Indicates whether the order item is eligible to be in a return request.
entered_options - [OrderItemOption]
The entered option for the base product, such as a logo or image.
gift_message - GiftMessage
The selected gift message for the order item
gift_wrapping - GiftWrapping
The selected gift wrapping for the order item.
id - ID!
The unique ID for an OrderItemInterface object.
product - ProductInterface
The ProductInterface object, which contains details about the base product
product_name - String
The name of the base product.
product_sale_price - Money!
The sale price of the base product, including selected options.
product_sku - String!
The SKU of the base product.
product_type - String
The type of product, such as simple, configurable, etc.
product_url_key - String
URL key of the base product.
quantity_canceled - Float
The number of canceled items.
quantity_invoiced - Float
The number of invoiced items.
quantity_ordered - Float
The number of units ordered for this item.
quantity_refunded - Float
The number of refunded items.
quantity_returned - Float
The number of returned items.
quantity_shipped - Float
The number of shipped items.
selected_options - [OrderItemOption]
The selected options for the base product, such as color or size.
status - String
The status of the order item.

Example

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

DownloadableProduct

Defines a product that the shopper downloads.

Fields

Field Name
Description
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.
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.
custom_attributesV2 - ProductCustomAttributes
Product custom attributes.
description - ComplexTextValue
Detailed information about the product. The value can include simple HTML tags.
downloadable_product_links - [DownloadableProductLinks]
An array containing information about the links for this downloadable product.
downloadable_product_samples - [DownloadableProductSamples]
An array containing information about samples of this downloadable product.
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.
links_purchased_separately - Int
A value of 1 indicates that each link in the array must be purchased separately.
links_title - String
The heading above the list of downloadable products.
manufacturer - Int
A number representing the product's manufacturer. (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_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.
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.
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.
short_description - ComplexTextValue
A short description of the product. Its use depends on the theme.
sku - String
A number or code assigned to a product to identify the product, options, price, and manufacturer.
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
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

{
  "attribute_set_id": 987,
  "canonical_url": "abc123",
  "categories": [CategoryInterface],
  "color": 987,
  "country_of_manufacture": "abc123",
  "created_at": "xyz789",
  "crosssell_products": [ProductInterface],
  "custom_attributesV2": ProductCustomAttributes,
  "description": ComplexTextValue,
  "downloadable_product_links": [
    DownloadableProductLinks
  ],
  "downloadable_product_samples": [
    DownloadableProductSamples
  ],
  "gift_message_available": "xyz789",
  "id": 987,
  "image": ProductImage,
  "is_returnable": "abc123",
  "links_purchased_separately": 987,
  "links_title": "abc123",
  "manufacturer": 123,
  "media_gallery": [MediaGalleryInterface],
  "media_gallery_entries": [MediaGalleryEntry],
  "meta_description": "abc123",
  "meta_keyword": "xyz789",
  "meta_title": "xyz789",
  "name": "xyz789",
  "new_from_date": "xyz789",
  "new_to_date": "abc123",
  "only_x_left_in_stock": 987.65,
  "options": [CustomizableOptionInterface],
  "options_container": "abc123",
  "price": ProductPrices,
  "price_range": PriceRange,
  "price_tiers": [TierPrice],
  "product_links": [ProductLinksInterface],
  "rating_summary": 987.65,
  "redirect_code": 123,
  "related_products": [ProductInterface],
  "relative_url": "xyz789",
  "review_count": 123,
  "reviews": ProductReviews,
  "short_description": ComplexTextValue,
  "sku": "xyz789",
  "small_image": ProductImage,
  "special_from_date": "abc123",
  "special_price": 123.45,
  "special_to_date": "abc123",
  "staged": false,
  "stock_status": "IN_STOCK",
  "swatch_image": "abc123",
  "thumbnail": ProductImage,
  "tier_price": 123.45,
  "tier_prices": [ProductTierPrices],
  "type": "CMS_PAGE",
  "type_id": "abc123",
  "uid": "4",
  "updated_at": "xyz789",
  "upsell_products": [ProductInterface],
  "url_key": "abc123",
  "url_path": "abc123",
  "url_rewrites": [UrlRewrite],
  "url_suffix": "xyz789",
  "websites": [Website]
}

DownloadableProductCartItemInput

Defines a single downloadable product.

Input Fields

Input Field
Description
customizable_options - [CustomizableOptionInput]
The ID and value of the option.
data - CartItemInput!
The quantity and SKU of the downloadable product.
downloadable_product_links - [DownloadableProductLinksInput]
An array of objects containing the link_id of the downloadable product link.

Example

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

Defines characteristics of a downloadable product.

Fields

Field Name
Description
id - Int
(Deprecated: This information should not be exposed on frontend.)
is_shareable - Boolean
(Deprecated: This information should not be exposed on frontend.)
link_type - DownloadableFileTypeEnum
(Deprecated: sample_url serves to get the downloadable sample)
number_of_downloads - Int
(Deprecated: This information should not be exposed on frontend.)
price - Float
The price of the downloadable product.
sample_file - String
(Deprecated: sample_url serves to get the downloadable sample)
sample_type - DownloadableFileTypeEnum
(Deprecated: sample_url serves to get the downloadable sample)
sample_url - String
The full URL to the downloadable sample.
sort_order - Int
A number indicating the sort order.
title - String
The display name of the link.
uid - ID!
The unique ID for a DownloadableProductLinks object.

Example

{
  "id": 123,
  "is_shareable": false,
  "link_type": "FILE",
  "number_of_downloads": 987,
  "price": 123.45,
  "sample_file": "xyz789",
  "sample_type": "FILE",
  "sample_url": "xyz789",
  "sort_order": 987,
  "title": "xyz789",
  "uid": "4"
}

DownloadableProductLinksInput

Contains the link ID for the downloadable product.

Input Fields

Input Field
Description
link_id - Int!
The unique ID of the downloadable product link.

Example

{"link_id": 987}

DownloadableProductSamples

Defines characteristics of a downloadable product.

Fields

Field Name
Description
id - Int
(Deprecated: This information should not be exposed on frontend.)
sample_file - String
(Deprecated: sample_url serves to get the downloadable sample)
sample_type - DownloadableFileTypeEnum
(Deprecated: sample_url serves to get the downloadable sample)
sample_url - String
The full URL to the downloadable sample.
sort_order - Int
A number indicating the sort order.
title - String
The display name of the sample.

Example

{
  "id": 123,
  "sample_file": "abc123",
  "sample_type": "FILE",
  "sample_url": "xyz789",
  "sort_order": 987,
  "title": "abc123"
}

DownloadableRequisitionListItem

Contains details about downloadable products added to a requisition list.

Fields

Field Name
Description
customizable_options - [SelectedCustomizableOption]!
Selected custom options for an item in the requisition list.
links - [DownloadableProductLinks]
An array of links for downloadable products in the requisition list.
product - ProductInterface!
Details about a requisition list item.
quantity - Float!
The quantity of the product added to the requisition list.
samples - [DownloadableProductSamples]
An array of links to downloadable product samples.
uid - ID!
The unique ID of an item in a requisition list.

Example

{
  "customizable_options": [SelectedCustomizableOption],
  "links": [DownloadableProductLinks],
  "product": ProductInterface,
  "quantity": 123.45,
  "samples": [DownloadableProductSamples],
  "uid": 4
}

DownloadableWishlistItem

A downloadable 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.
links_v2 - [DownloadableProductLinks]
An array containing information about the selected links.
product - ProductInterface
Product details of the wish list item.
quantity - Float!
The quantity of this wish list item.
samples - [DownloadableProductSamples]
An array containing information about the selected samples.

Example

{
  "added_at": "abc123",
  "customizable_options": [SelectedCustomizableOption],
  "description": "abc123",
  "id": "4",
  "links_v2": [DownloadableProductLinks],
  "product": ProductInterface,
  "quantity": 987.65,
  "samples": [DownloadableProductSamples]
}

DuplicateNegotiableQuoteInput

Identifies a quote to be duplicated

Input Fields

Input Field
Description
duplicated_quote_uid - ID!
ID for the newly duplicated quote.
quote_uid - ID!
ID of the quote to be duplicated.

Example

{
  "duplicated_quote_uid": "4",
  "quote_uid": 4
}

DuplicateNegotiableQuoteOutput

Contains the newly created negotiable quote.

Fields

Field Name
Description
quote - NegotiableQuote
Negotiable Quote resulting from duplication operation.

Example

{"quote": NegotiableQuote}

DynamicBlock

Contains a single dynamic block.

Fields

Field Name
Description
content - ComplexTextValue!
The renderable HTML code of the dynamic block.
uid - ID!
The unique ID of a DynamicBlock object.

Example

{
  "content": ComplexTextValue,
  "uid": "4"
}

DynamicBlockLocationEnum

Indicates the locations the dynamic block can be placed. If this field is not specified, the query returns all locations.

Values

Enum Value
Description
CONTENT
HEADER
FOOTER
LEFT
RIGHT

Example

""CONTENT""

DynamicBlockTypeEnum

Indicates the selected Dynamic Blocks Rotator inline widget.

Values

Enum Value
Description
SPECIFIED
CART_PRICE_RULE_RELATED
CATALOG_PRICE_RULE_RELATED

Example

""SPECIFIED""

DynamicBlocks

Contains an array of dynamic blocks.

Fields

Field Name
Description
items - [DynamicBlock]!
An array containing individual dynamic blocks.
page_info - SearchResultPageInfo
Metadata for pagination rendering.
total_count - Int!
The number of returned dynamic blocks.

Example

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

DynamicBlocksFilterInput

Defines the dynamic block filter. The filter can identify the block type, location and IDs to return.

Input Fields

Input Field
Description
dynamic_block_uids - [ID]
An array of dynamic block UIDs to filter on.
locations - [DynamicBlockLocationEnum]
An array indicating the locations the dynamic block can be placed.
type - DynamicBlockTypeEnum!
A value indicating the type of dynamic block to filter on.

Example

{
  "dynamic_block_uids": ["4"],
  "locations": ["CONTENT"],
  "type": "SPECIFIED"
}

EnteredCustomAttributeInput

Contains details about a custom text attribute that the buyer entered.

Input Fields

Input Field
Description
attribute_code - String!
A string that identifies the entered custom attribute.
value - String!
The text or other entered value.

Example

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

EnteredOptionInput

Defines a customer-entered option.

Input Fields

Input Field
Description
uid - ID!
The unique ID for a CustomizableOptionInterface object, such as a CustomizableFieldOption, CustomizableFileOption, or CustomizableAreaOption object.
value - String!
Text the customer entered.

Example

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

EntityUrl

Contains the uid, relative_url, and type attributes.

Fields

Field Name
Description
canonical_url - String
(Deprecated: Use relative_url instead.)
entity_uid - ID
The unique ID for a ProductInterface, CategoryInterface, CmsPage, or similar object associated with the specified URL. This could be a product, category, or CMS page UID.
id - Int
The ID assigned to the object associated with the specified url. This could be a product ID, category ID, or page ID. (Deprecated: Use entity_uid instead.)
redirectCode - 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.

Example

{
  "canonical_url": "xyz789",
  "entity_uid": 4,
  "id": 987,
  "redirectCode": 987,
  "relative_url": "abc123",
  "type": "CMS_PAGE"
}

ErrorInterface

Fields

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

Possible Types

Example

{"message": "abc123"}

EstimateAddressInput

Contains details about an address.

Input Fields

Input Field
Description
country_code - CountryCodeEnum!
The two-letter code representing the customer's country.
postcode - String
The customer's ZIP or postal code.
region - CustomerAddressRegionInput
An object containing the region name, region code, and region ID.

Example

{
  "country_code": "AF",
  "postcode": "xyz789",
  "region": CustomerAddressRegionInput
}

EstimateTotalsInput

Input Fields

Input Field
Description
address - EstimateAddressInput!
Customer's address to estimate totals.
cart_id - String!
The unique ID of the cart to query.
shipping_method - ShippingMethodInput
Selected shipping method to estimate totals.

Example

{
  "address": EstimateAddressInput,
  "cart_id": "xyz789",
  "shipping_method": ShippingMethodInput
}

EstimateTotalsOutput

Estimate totals output.

Fields

Field Name
Description
cart - Cart
Cart after totals estimation

Example

{"cart": Cart}

ExchangeRate

Lists the exchange rate.

Fields

Field Name
Description
currency_to - String
Specifies the store’s default currency to exchange to.
rate - Float
The exchange rate for the store’s default currency.

Example

{"currency_to": "abc123", "rate": 987.65}

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"}