Types

AcceptNegotiableQuoteTemplateInput

Specifies the quote template id to accept quote template.

Input Fields

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

Example

{"template_id": "4"}

AddCustomAttributesToCartItemOutput

Contains details about the cart after adding custom attributes to it items.

Fields

Field Name
Description
cart - Cart!
The custom attributes to cart item have been added.

Example

{"cart": Cart}

AddDownloadableProductsToCartInput

Input Fields

Input Field
Description
cart_id - String!
The ID of the cart.
cart_items - [DownloadableProductCartItemInput]!
An array of downloadable products to add.

Example

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

AddDownloadableProductsToCartOutput

Contains details about the cart after adding downloadable products.

Fields

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

Example

{"cart": Cart}

AddGiftRegistryRegistrantInput

Defines a new registrant.

Input Fields

Input Field
Description
dynamic_attributes - [GiftRegistryDynamicAttributeInput]
Additional attributes specified as a code-value pair.
email - String!
The email address of the registrant.
firstname - String!
The first name of the registrant.
lastname - String!
The last name of the registrant.

Example

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

AddGiftRegistryRegistrantsOutput

Contains the results of a request to add registrants.

Fields

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

Example

{"gift_registry": GiftRegistry}

AddProductsToCartOutput

Contains details about the cart after adding products to it.

Fields

Field Name
Description
cart - Cart!
The cart after products have been added.
user_errors - [Error]!
Contains errors encountered while adding an item to the cart.

Example

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

AddProductsToCompareListInput

Contains products to add to an existing compare list.

Input Fields

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

Example

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

AddProductsToNewCartOutput

Contains details about the cart after adding products to it.

Fields

Field Name
Description
cart - Cart
The cart after products have been added.
user_errors - [CartUserInputError]
Contains errors encountered while adding an item to the cart.

Example

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

AddProductsToRequisitionListOutput

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

Fields

Field Name
Description
requisition_list - RequisitionList
The requisition list after adding products.

Example

{"requisition_list": RequisitionList}

AddProductsToWishlistOutput

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

Fields

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

Example

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

AddPurchaseOrderCommentInput

Contains the comment to be added to a purchase order.

Input Fields

Input Field
Description
comment - String!
Comment text.
purchase_order_uid - ID!
The unique ID of a purchase order.

Example

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

AddPurchaseOrderCommentOutput

Contains the successfully added comment.

Fields

Field Name
Description
comment - PurchaseOrderComment!
The purchase order comment.

Example

{"comment": PurchaseOrderComment}

AddPurchaseOrderItemsToCartInput

Defines the purchase order and cart to act on.

Input Fields

Input Field
Description
cart_id - String!
The ID to assign to the cart.
purchase_order_uid - ID!
Purchase order unique ID.
replace_existing_cart_items - Boolean!
Replace existing cart or merge items.

Example

{
  "cart_id": "xyz789",
  "purchase_order_uid": 4,
  "replace_existing_cart_items": false
}

AddRequisitionListItemToCartUserError

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

Fields

Field Name
Description
message - String!
A description of the error.
type - AddRequisitionListItemToCartUserErrorType!
The type of error that occurred.

Example

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

AddRequisitionListItemToCartUserErrorType

Values

Enum Value
Description
OUT_OF_STOCK
UNAVAILABLE_SKU
OPTIONS_UPDATED
LOW_QUANTITY

Example

""OUT_OF_STOCK""

AddRequisitionListItemsToCartOutput

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

Fields

Field Name
Description
add_requisition_list_items_to_cart_user_errors - [AddRequisitionListItemToCartUserError]!
Details about why the attempt to add items to the requistion list was not successful.
cart - Cart
The cart after adding requisition list items.
status - Boolean!
Indicates whether the attempt to add items to the requisition list was successful.

Example

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

AddReturnCommentInput

Defines a return comment.

Input Fields

Input Field
Description
comment_text - String!
The text added to the return request.
return_uid - ID!
The unique ID for a `Return` object.

Example

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

AddReturnCommentOutput

Contains details about the return request.

Fields

Field Name
Description
return - Return
The modified return.

Example

{"return": Return}

AddReturnTrackingInput

Defines tracking information to be added to the return.

Input Fields

Input Field
Description
carrier_uid - ID!
The unique ID for a `ReturnShippingCarrier` object.
return_uid - ID!
The unique ID for a `Returns` object.
tracking_number - String!
The shipping tracking number for this return request.

Example

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

AddReturnTrackingOutput

Contains the response after adding tracking information.

Fields

Field Name
Description
return - Return
Details about the modified return.
return_shipping_tracking - ReturnShippingTracking
Details about shipping for a return.

Example

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

AddWishlistItemsToCartOutput

Contains the resultant wish list and any error information.

Fields

Field Name
Description
add_wishlist_items_to_cart_user_errors - [WishlistCartUserInputError]!
An array of errors encountered while adding products to the customer's cart.
status - Boolean!
Indicates whether the attempt to add items to the customer's cart was successful.
wishlist - Wishlist!
Contains the wish list with all items that were successfully added.

Example

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

Aggregation

A bucket that contains information for each filterable option

Fields

Field Name
Description
attribute - String!
The attribute code of the filter item
buckets - [Bucket]!
A container that divides the data into manageable groups. For example, attributes that can have numeric values might have buckets that define price ranges
title - String!
The filter name displayed in layered navigation
type - AggregationType
Identifies the data type of the aggregation

Example

{
  "attribute": "xyz789",
  "buckets": [Bucket],
  "title": "xyz789",
  "type": "INTELLIGENT"
}

AggregationType

Identifies the data type of the aggregation

Values

Enum Value
Description
INTELLIGENT
PINNED
POPULAR

Example

""INTELLIGENT""

ApplePayConfig

Fields

Field Name
Description
button_styles - ButtonStyles
The styles for the ApplePay Smart Button configuration
code - String
The payment method code as defined in the payment gateway
is_visible - Boolean
Indicates whether the payment method is displayed
payment_intent - String
Defines the payment intent (Authorize or Capture
payment_source - String
The payment source for the payment method
sdk_params - [SDKParams]
The PayPal parameters required to load the JS SDK
sort_order - String
The relative order the payment method is displayed on the checkout page
title - String
The name displayed for the payment method

Example

{
  "button_styles": ButtonStyles,
  "code": "xyz789",
  "is_visible": true,
  "payment_intent": "abc123",
  "payment_source": "abc123",
  "sdk_params": [SDKParams],
  "sort_order": "abc123",
  "title": "abc123"
}

ApplePayMethodInput

Apple Pay inputs

Input Fields

Input Field
Description
payment_source - String
The payment source for the payment method
payments_order_id - String
The payment services order ID
paypal_order_id - String
PayPal order ID

Example

{
  "payment_source": "xyz789",
  "payments_order_id": "abc123",
  "paypal_order_id": "xyz789"
}

AppliedCoupon

Contains the applied coupon code.

Fields

Field Name
Description
code - String!
The coupon code the shopper applied to the card.

Example

{"code": "xyz789"}

AppliedGiftCard

Contains an applied gift card with applied and remaining balance.

Fields

Field Name
Description
applied_balance - Money
The amount applied to the current cart.
code - String
The gift card account code.
current_balance - Money
The remaining balance on the gift card.
expiration_date - String
The expiration date of the gift card.

Example

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

AppliedQueryRule

The rule that was applied to this product

Fields

Field Name
Description
action_type - AppliedQueryRuleActionType
An enum that defines the type of rule that was applied
rule_id - String
The ID assigned to the rule
rule_name - String
The name of the applied rule

Example

{
  "action_type": "BOOST",
  "rule_id": "xyz789",
  "rule_name": "xyz789"
}

AppliedQueryRuleActionType

The type of rule that was applied to a product during search (optional)

Values

Enum Value
Description
BOOST
BURY
PIN

Example

""BOOST""

AppliedStoreCredit

Contains the applied and current balances.

Fields

Field Name
Description
applied_balance - Money
The applied store credit balance to the current cart.
current_balance - Money
The current balance remaining on store credit.
enabled - Boolean
Indicates whether store credits are enabled. If the feature is disabled, then the current balance will not be returned.

Example

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

ApplyCouponToCartInput

Specifies the coupon code to apply to the cart.

Input Fields

Input Field
Description
cart_id - String!
The unique ID of a `Cart` object.
coupon_code - String!
A valid coupon code.

Example

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

ApplyCouponToCartOutput

Contains details about the cart after applying a coupon.

Fields

Field Name
Description
cart - Cart!
The cart after applying a coupon.

Example

{"cart": Cart}

ApplyCouponsStrategy

The strategy to apply coupons to the cart.

Values

Enum Value
Description
APPEND
Append new coupons keeping the coupons that have been applied before.
REPLACE
Remove all the coupons from the cart and apply only new provided coupons.

Example

""APPEND""

ApplyCouponsToCartInput

Apply coupons to the cart.

Input Fields

Input Field
Description
cart_id - String!
The unique ID of a `Cart` object.
coupon_codes - [String]!
An array of valid coupon codes.
type - ApplyCouponsStrategy
`replace` to replace the existing coupon(s) or `append` to add the coupon to the coupon(s) list.

Example

{
  "cart_id": "xyz789",
  "coupon_codes": ["abc123"],
  "type": "APPEND"
}

ApplyGiftCardToCartInput

Defines the input required to run the applyGiftCardToCart mutation.

Input Fields

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

Example

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

ApplyGiftCardToCartOutput

Defines the possible output for the applyGiftCardToCart mutation.

Fields

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

Example

{"cart": Cart}

ApplyGiftCardToOrder

Contains applied gift cards with gift card code and amount.

Fields

Field Name
Description
applied_balance - Money!
The gift card amount applied to the current order.
code - String!
The gift card account code.

Example

{
  "applied_balance": Money,
  "code": "abc123"
}

ApplyRewardPointsToCartOutput

Contains the customer cart.

Fields

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

Example

{"cart": Cart}

ApplyStoreCreditToCartInput

Defines the input required to run the applyStoreCreditToCart mutation.

Input Fields

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

Example

{"cart_id": "xyz789"}

ApplyStoreCreditToCartOutput

Defines the possible output for the applyStoreCreditToCart mutation.

Fields

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

Example

{"cart": Cart}

AreaInput

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

Input Fields

Input Field
Description
radius - Int!
The radius for the search in KM.
search_term - String!
The country code where search must be performed. Required parameter together with region, city or postcode.

Example

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

AssetImage

Contains information about an asset image.

Fields

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

Example

{
  "asset_image": ProductMediaGalleryEntriesAssetImage,
  "disabled": true,
  "label": "xyz789",
  "position": 123,
  "url": "xyz789"
}

AssetVideo

Contains information about an asset video.

Fields

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

Example

{
  "asset_video": ProductMediaGalleryEntriesAssetVideo,
  "disabled": false,
  "label": "abc123",
  "position": 123,
  "url": "abc123"
}

AssignCompareListToCustomerOutput

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

Fields

Field Name
Description
compare_list - CompareList
The contents of the customer's compare list.
result - Boolean!
Indicates whether the compare list was successfully assigned to the customer.

Example

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

AttributeEntityTypeEnum

List of all entity types. Populated by the modules introducing EAV entities.

Values

Enum Value
Description
CATALOG_PRODUCT
CATALOG_CATEGORY
CUSTOMER
CUSTOMER_ADDRESS
RMA_ITEM

Example

""CATALOG_PRODUCT""

AttributeFile

Fields

Field Name
Description
attribute_type - String
Attribute type code.
code - ID!
The attribute code.
url - String!
File URL to download the file.
value - String!
File code. For file download use `url` field.

Example

{
  "attribute_type": "abc123",
  "code": "4",
  "url": "abc123",
  "value": "abc123"
}

AttributeFilterInput

An input object that specifies the filters used for attributes.

Input Fields

Input Field
Description
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_searchable - Boolean
Whether a product or category attribute can be searched or not.
is_used_for_customer_segment - Boolean
Whether a customer or customer address attribute is used for customer segment or not.
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.
used_in_product_listing - Boolean
Whether a product or category attribute is used in product listing or not.

Example

{
  "is_comparable": true,
  "is_filterable": false,
  "is_filterable_in_search": false,
  "is_html_allowed_on_front": false,
  "is_searchable": false,
  "is_used_for_customer_segment": true,
  "is_used_for_price_rules": true,
  "is_used_for_promo_rules": false,
  "is_visible_in_advanced_search": true,
  "is_visible_on_front": false,
  "is_wysiwyg_enabled": true,
  "used_in_product_listing": false
}

AttributeFrontendInputEnum

EAV attribute frontend input types.

Values

Enum Value
Description
BOOLEAN
DATE
DATETIME
FILE
GALLERY
HIDDEN
IMAGE
MEDIA_IMAGE
MULTILINE
MULTISELECT
PRICE
SELECT
TEXT
TEXTAREA
WEIGHT
UNDEFINED

Example

""BOOLEAN""

AttributeImage

Fields

Field Name
Description
attribute_type - String
Attribute type code.
code - ID!
The attribute code.
url - String!
Image URL to download the image.
value - String!
Image code. For image download use `url` field.

Example

{
  "attribute_type": "xyz789",
  "code": 4,
  "url": "xyz789",
  "value": "xyz789"
}

AttributeInput

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

Input Fields

Input Field
Description
attribute_code - String
The unique identifier for an attribute code. This value should be in lowercase letters without spaces.
entity_type - String
The type of entity that defines the attribute.

Example

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

AttributeInputSelectedOption

Specifies selected option for a select or multiselect attribute value.

Input Fields

Input Field
Description
value - String!
The attribute option value.

Example

{"value": "xyz789"}

AttributeMetadata

Base EAV implementation of CustomAttributeMetadataInterface.

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.

Example

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

AttributeMetadataError

Attribute metadata retrieval error.

Fields

Field Name
Description
message - String!
Attribute metadata retrieval error message.
type - AttributeMetadataErrorType!
Attribute metadata retrieval error type.

Example

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

AttributeMetadataErrorType

Attribute metadata retrieval error types.

Values

Enum Value
Description
ENTITY_NOT_FOUND
The requested entity was not found.
ATTRIBUTE_NOT_FOUND
The requested attribute was not found.
FILTER_NOT_FOUND
The filter cannot be applied as it does not belong to the entity
UNDEFINED
Not categorized error, see the error message.

Example

""ENTITY_NOT_FOUND""

AttributeMetadataResponse

Contains the output of the attributeMetadata query

Fields

Field Name
Description
filterableInSearch - [FilterableInSearchAttribute!]
An array of product attributes that can be used for filtering in a `productSearch` query
sortable - [SortableAttribute!]
An array of product attributes that can be used for sorting in a `productSearch` query

Example

{
  "filterableInSearch": [FilterableInSearchAttribute],
  "sortable": [SortableAttribute]
}

AttributeOptionMetadata

Base EAV implementation of 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.

Example

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

AttributeSelectedOption

Fields

Field Name
Description
label - String!
The attribute selected option label.
value - String!
The attribute selected option value.

Example

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

AttributeSelectedOptionInterface

Fields

Field Name
Description
label - String!
The attribute selected option label.
value - String!
The attribute selected option value.

Possible Types

AttributeSelectedOptionInterface Types
AttributeSelectedOption

Example

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

AttributeSelectedOptions

Fields

Field Name
Description
attribute_type - String
Attribute type code.
code - ID!
The attribute code.
selected_options - [AttributeSelectedOptionInterface]!

Example

{
  "attribute_type": "xyz789",
  "code": 4,
  "selected_options": [AttributeSelectedOptionInterface]
}

AttributeValue

Fields

Field Name
Description
attribute_type - String
Attribute type code.
code - ID!
The attribute code.
value - String!
The attribute value.

Example

{
  "attribute_type": "abc123",
  "code": "4",
  "value": "abc123"
}

AttributeValueInput

Specifies the value for attribute.

Input Fields

Input Field
Description
attribute_code - String!
The code of the attribute.
selected_options - [AttributeInputSelectedOption]
An array containing selected options for a select or multiselect attribute.
value - String
The value assigned to the attribute.

Example

{
  "attribute_code": "xyz789",
  "selected_options": [AttributeInputSelectedOption],
  "value": "xyz789"
}

AttributeValueInterface

Fields

Field Name
Description
attribute_type - String
Attribute type code.
code - ID!
The attribute code.

Possible Types

Example

{"attribute_type": "abc123", "code": 4}

AttributesFormOutput

Metadata of EAV attributes associated to form

Fields

Field Name
Description
errors - [AttributeMetadataError]!
Errors of retrieving certain attributes metadata.
items - [CustomAttributeMetadataInterface]!
Requested attributes metadata.

Example

{
  "errors": [AttributeMetadataError],
  "items": [CustomAttributeMetadataInterface]
}

AttributesMetadataOutput

Metadata of EAV attributes.

Fields

Field Name
Description
errors - [AttributeMetadataError]!
Errors of retrieving certain attributes metadata.
items - [CustomAttributeMetadataInterface]!
Requested attributes metadata.

Example

{
  "errors": [AttributeMetadataError],
  "items": [CustomAttributeMetadataInterface]
}

AvailableCurrency

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

Fields

Field Name
Description
code - CurrencyEnum!
3-letter currency code, for example USD.
symbol - String!
Currency symbol, for example $.

Example

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

AvailablePaymentMethod

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

Fields

Field Name
Description
code - String!
The payment method code.
is_deferred - Boolean!
If the payment method is an online integration
oope_payment_method_config - OopePaymentMethodConfig
Configuration for out of process payment methods
title - String!
The payment method title.

Example

{
  "code": "xyz789",
  "is_deferred": true,
  "oope_payment_method_config": OopePaymentMethodConfig,
  "title": "xyz789"
}

AvailableShippingMethod

Contains details about the possible shipping methods and carriers.

Fields

Field Name
Description
additional_data - [ShippingAdditionalData]
Additional data related to the shipping method.
amount - Money!
The cost of shipping using this shipping method.
available - Boolean!
Indicates whether this shipping method can be applied to the cart.
carrier_code - String!
A string that identifies a commercial carrier or an offline shipping method.
carrier_title - String!
The label for the carrier code.
error_message - String
Describes an error condition.
method_code - String
A shipping method code associated with a carrier. The value could be null if no method is available.
method_title - String
The label for the shipping method code. The value could be null if no method is available.
price_excl_tax - Money!
The cost of shipping using this shipping method, excluding tax.
price_incl_tax - Money!
The cost of shipping using this shipping method, including tax.

Example

{
  "additional_data": [ShippingAdditionalData],
  "amount": Money,
  "available": true,
  "carrier_code": "abc123",
  "carrier_title": "xyz789",
  "error_message": "abc123",
  "method_code": "abc123",
  "method_title": "abc123",
  "price_excl_tax": Money,
  "price_incl_tax": Money
}

BatchMutationStatus

Values

Enum Value
Description
SUCCESS
FAILURE
MIXED_RESULTS

Example

""SUCCESS""

BillingAddressInput

Defines the billing address.

Input Fields

Input Field
Description
address - CartAddressInput
Defines a billing address.
customer_address_id - Int
An ID from the customer's address book that uniquely identifies the address to be used for billing.
customer_address_uid - ID
The unique ID from the customer's address book that uniquely identifies the address to be used for billing.
same_as_shipping - Boolean
Indicates whether to set the billing address to be the same as the existing shipping address on the cart.
use_for_shipping - Boolean
Indicates whether to set the shipping address to be the same as this billing address.

Example

{
  "address": CartAddressInput,
  "customer_address_id": 987,
  "customer_address_uid": "4",
  "same_as_shipping": true,
  "use_for_shipping": false
}

BillingAddressPaymentSourceInput

The billing address information

Input Fields

Input Field
Description
address_line_1 - String
The first line of the address
address_line_2 - String
The second line of the address
city - String
The city of the address
country_code - String!
The country of the address
postal_code - String
The postal code of the address
region - String
The region of the address

Example

{
  "address_line_1": "abc123",
  "address_line_2": "abc123",
  "city": "abc123",
  "country_code": "abc123",
  "postal_code": "abc123",
  "region": "abc123"
}

BillingCartAddress

Contains details about the billing address.

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.
customer_address_uid - ID
The unique ID from the customer's address book that uniquely identifies the address.
fax - String
The customer's fax number.
firstname - String!
The first name of the customer or guest.
id - Int
Id of the customer address. (Deprecated: Use `customer_address_uid` instead.)
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 - ID!
The unique id of the customer cart address.
vat_id - String
The VAT company number for billing or shipping address.

Example

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

Boolean

The Boolean scalar type represents true or false.

Example

true

Contains details about an individual category that comprises a breadcrumb.

Fields

Field Name
Description
category_level - Int
The category level.
category_name - String
The display name of the category.
category_uid - ID!
The unique ID for a `Breadcrumb` object.
category_url_key - String
The URL key of the category.
category_url_path - String
The URL path of the category.

Example

{
  "category_level": 123,
  "category_name": "abc123",
  "category_uid": "4",
  "category_url_key": "abc123",
  "category_url_path": "abc123"
}

Bucket

An interface for bucket contents

Fields

Field Name
Description
title - String!
A human-readable name of a bucket

Possible Types

Example

{"title": "abc123"}

BundleCartItem

An implementation for bundle product cart items.

Fields

Field Name
Description
available_gift_wrapping - [GiftWrapping]!
The list of available gift wrapping options for the cart item.
bundle_options - [SelectedBundleOption]!
An array containing the bundle options the shopper selected.
custom_attributes - [CustomAttribute]
The custom attributes for 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.
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
not_available_message - String
Message to display when the product is not available with this selected option.
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. (Deprecated: Product information is part of a composable Catalog Service.)
quantity - Float!
The quantity of this item in the cart.
uid - ID!
The unique ID for a `CartItemInterface` object.

Example

{
  "available_gift_wrapping": [GiftWrapping],
  "bundle_options": [SelectedBundleOption],
  "custom_attributes": [CustomAttribute],
  "customizable_options": [SelectedCustomizableOption],
  "discount": [Discount],
  "errors": [CartItemError],
  "gift_message": GiftMessage,
  "gift_wrapping": GiftWrapping,
  "is_available": false,
  "max_qty": 123.45,
  "min_qty": 123.45,
  "not_available_message": "xyz789",
  "note_from_buyer": [ItemNote],
  "note_from_seller": [ItemNote],
  "prices": CartItemPrices,
  "product": ProductInterface,
  "quantity": 123.45,
  "uid": 4
}

BundleCreditMemoItem

Defines bundle product options for CreditMemoItemInterface.

Fields

Field Name
Description
bundle_options - [ItemSelectedBundleOption]
A list of bundle options that are assigned to a bundle product that is part of a credit memo.
custom_attributes - [CustomAttribute]
The custom attributes for the credit memo item
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

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

BundleInvoiceItem

Defines bundle product options for InvoiceItemInterface.

Fields

Field Name
Description
bundle_options - [ItemSelectedBundleOption]
A list of bundle options that are assigned to an invoiced bundle product.
custom_attributes - [CustomAttribute]
The custom attributes for the invoice item
discounts - [Discount]
Information about the final discount amount for the base product, including discounts on options.
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

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

BundleItem

Defines an individual item within a bundle product.

Fields

Field Name
Description
options - [BundleItemOption]
An array of additional options for this bundle item.
position - Int
A number indicating the sequence order of this item compared to the other bundle items.
price_range - PriceRange!
The range of prices for the product
required - Boolean
Indicates whether the item must be included in the bundle.
sku - String
The SKU of the bundle product.
title - String
The display name of the item.
type - String
The input type that the customer uses to select the item. Examples include radio button and checkbox.
uid - ID
The unique ID for a `BundleItem` object.

Example

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

BundleItemOption

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

Fields

Field Name
Description
can_change_quantity - Boolean
Indicates whether the customer can change the number of items for this option.
is_default - Boolean
Indicates whether this option is the default option.
label - String
The text that identifies the bundled item option.
position - Int
When a bundle item contains multiple options, the relative position of this option compared to the other options.
price - Float
The price of the selected option.
price_type - PriceTypeEnum
One of FIXED, PERCENT, or DYNAMIC.
product - ProductInterface
Contains details about this product option.
quantity - Float
The quantity of this specific bundle item.
uid - ID!
The unique ID for a `BundleItemOption` object.

Example

{
  "can_change_quantity": true,
  "is_default": true,
  "label": "abc123",
  "position": 987,
  "price": 987.65,
  "price_type": "FIXED",
  "product": ProductInterface,
  "quantity": 123.45,
  "uid": "4"
}

BundleOrderItem

Defines bundle product options for OrderItemInterface.

Fields

Field Name
Description
bundle_options - [ItemSelectedBundleOption]
A list of bundle options that are assigned to the bundle product.
custom_attributes - [CustomAttribute]
The custom attributes for the order item
discounts - [Discount]
The final discount information for the 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.
parent_sku - String
The SKU of parent product.
prices - OrderItemPrices
Contains details about the price of the item, including taxes and discounts.
product - ProductInterface
The ProductInterface object, which contains details about the base product (Deprecated: Product information is part of a composable Catalog Service.)
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_return_requested - Float
The requested return quantity of the item.
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

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

BundleProduct

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

Fields

Field Name
Description
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.
country_of_manufacture - String
The product's country of origin.
crosssell_products - [ProductInterface]
Crosssell Products
custom_attributesV2 - ProductCustomAttributes
Product custom attributes.
description - ComplexTextValue
Detailed information about the product. The value can include simple HTML tags.
dynamic_price - Boolean
Indicates whether the bundle product has a dynamic price.
dynamic_sku - Boolean
Indicates whether the bundle product has a dynamic SKU.
dynamic_weight - Boolean
Indicates whether the bundle product has a dynamically calculated weight.
gift_message_available - Boolean!
Returns a value indicating gift message availability for the product.
gift_wrapping_available - Boolean!
Returns a value indicating gift wrapping availability for the product.
gift_wrapping_price - Money
Returns value and currency indicating gift wrapping price for the product.
image - ProductImage
The relative path to the main image on the product page.
is_returnable - String
Indicates whether the product can be returned.
items - [BundleItem]
An array containing information about individual bundle items.
manufacturer - Int
A number representing the product's manufacturer.
max_sale_qty - Float
Maximum Qty Allowed in Shopping Cart
media_gallery - [MediaGalleryInterface]
An array of media gallery objects.
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.
min_sale_qty - Float
Minimum Qty Allowed in Shopping Cart
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_details - PriceDetails
The price details of the main product
price_range - PriceRange!
The range of prices for the product
price_tiers - [TierPrice]
An array of `TierPrice` objects.
price_view - PriceViewEnum
One of PRICE_RANGE or AS_LOW_AS.
product_links - [ProductLinksInterface]
An array of `ProductLinks` objects.
quantity - Float
Quantity of available stock
related_products - [ProductInterface]
An array of products to be displayed in a Related Products block.
ship_bundle_items - ShipBundleItemsEnum
Indicates whether to ship bundle items together or individually.
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_price - Float
The discounted price of the product.
special_to_date - String
The end date for a product with a special price.
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.
uid - ID!
The unique ID for a `ProductInterface` object.
upsell_products - [ProductInterface]
Upsell Products
url_key - String
The part of the URL that identifies the product
weight - Float
The weight of the item, in units defined by the store.

Example

{
  "canonical_url": "xyz789",
  "categories": [CategoryInterface],
  "country_of_manufacture": "abc123",
  "crosssell_products": [ProductInterface],
  "custom_attributesV2": ProductCustomAttributes,
  "description": ComplexTextValue,
  "dynamic_price": true,
  "dynamic_sku": false,
  "dynamic_weight": false,
  "gift_message_available": true,
  "gift_wrapping_available": true,
  "gift_wrapping_price": Money,
  "image": ProductImage,
  "is_returnable": "abc123",
  "items": [BundleItem],
  "manufacturer": 987,
  "max_sale_qty": 987.65,
  "media_gallery": [MediaGalleryInterface],
  "meta_description": "abc123",
  "meta_keyword": "abc123",
  "meta_title": "xyz789",
  "min_sale_qty": 987.65,
  "name": "xyz789",
  "new_from_date": "abc123",
  "new_to_date": "abc123",
  "only_x_left_in_stock": 987.65,
  "options": [CustomizableOptionInterface],
  "options_container": "xyz789",
  "price_details": PriceDetails,
  "price_range": PriceRange,
  "price_tiers": [TierPrice],
  "price_view": "PRICE_RANGE",
  "product_links": [ProductLinksInterface],
  "quantity": 123.45,
  "related_products": [ProductInterface],
  "ship_bundle_items": "TOGETHER",
  "short_description": ComplexTextValue,
  "sku": "abc123",
  "small_image": ProductImage,
  "special_price": 987.65,
  "special_to_date": "abc123",
  "stock_status": "IN_STOCK",
  "swatch_image": "xyz789",
  "thumbnail": ProductImage,
  "uid": "4",
  "upsell_products": [ProductInterface],
  "url_key": "xyz789",
  "weight": 123.45
}

BundleRequisitionListItem

Contains details about bundle products added to a requisition list.

Fields

Field Name
Description
bundle_options - [SelectedBundleOption]!
An array of selected options for a bundle product.
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.
sku - String!
The product SKU.
uid - ID!
The unique ID of an item in a requisition list.

Example

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

BundleShipmentItem

Defines bundle product options for ShipmentItemInterface.

Fields

Field Name
Description
bundle_options - [ItemSelectedBundleOption]
A list of bundle options that are assigned to a shipped product.
id - ID!
The unique ID for a `ShipmentItemInterface` object.
order_item - OrderItemInterface
The order item associated with the shipment item.
product_name - String
The name of the base product.
product_sale_price - Money!
The sale price for the base product.
product_sku - String!
The SKU of the base product.
quantity_shipped - Float!
The number of shipped items.

Example

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

BundleWishlistItem

Defines bundle product options for WishlistItemInterface.

Fields

Field Name
Description
added_at - String!
The date and time the item was added to the wish list.
bundle_options - [SelectedBundleOption]
An array containing information about the selected bundle items.
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. (Deprecated: Product information is part of a composable Catalog Service.)
quantity - Float!
The quantity of this wish list item.

Example

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

ButtonStyles

Fields

Field Name
Description
color - String
The button color
height - Int
The button height in pixels
label - String
The button label
layout - String
The button layout
shape - String
The button shape
tagline - Boolean
Indicates whether the tagline is displayed
use_default_height - Boolean
Defines if the button uses default height. If the value is false, the value of height is used

Example

{
  "color": "abc123",
  "height": 123,
  "label": "abc123",
  "layout": "abc123",
  "shape": "abc123",
  "tagline": false,
  "use_default_height": true
}

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

CancelOrderError

Fields

Field Name
Description
code - CancelOrderErrorCode!
An error code that is specific to cancel order.
message - String!
A localized error message.

Example

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

CancelOrderErrorCode

Values

Enum Value
Description
ORDER_CANCELLATION_DISABLED
UNDEFINED
UNAUTHORISED
ORDER_NOT_FOUND
PARTIAL_ORDER_ITEM_SHIPPED
INVALID_ORDER_STATUS

Example

""ORDER_CANCELLATION_DISABLED""

CancelOrderInput

Defines the order to cancel.

Input Fields

Input Field
Description
order_id - ID!
The unique ID of an `Order` type.
reason - String!
Cancellation reason.

Example

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

CancelOrderOutput

Contains the updated customer order and error message if any.

Fields

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

Example

{
  "error": "xyz789",
  "errorV2": CancelOrderError,
  "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": "abc123",
  "card_expiry_year": "abc123",
  "last_digits": "xyz789",
  "name": "abc123"
}

CardBin

Fields

Field Name
Description
bin - String
Card bin number

Example

{"bin": "xyz789"}

CardPaymentSourceInput

The card payment source information

Input Fields

Input Field
Description
billing_address - BillingAddressPaymentSourceInput!
The billing address of the card
name - String
The name on the cardholder

Example

{
  "billing_address": BillingAddressPaymentSourceInput,
  "name": "abc123"
}

CardPaymentSourceOutput

The card payment source information

Fields

Field Name
Description
brand - String
The brand of the card
expiry - String
The expiry of the card
last_digits - String
The last digits of the card

Example

{
  "brand": "abc123",
  "expiry": "abc123",
  "last_digits": "abc123"
}

Cart

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

Fields

Field Name
Description
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.
custom_attributes - [CustomAttribute]
The custom attributes for 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.
itemsV2 - CartItems
prices - CartPrices
Pricing details for the quote.
printed_card_included - Boolean!
Indicates whether the shopper requested a printed card for the cart.
rules - [CartRuleStorefront]
Provides applied cart rules in the current active 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_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,
  "custom_attributes": [CustomAttribute],
  "email": "abc123",
  "gift_message": GiftMessage,
  "gift_receipt_included": true,
  "gift_wrapping": GiftWrapping,
  "id": "4",
  "is_virtual": false,
  "itemsV2": CartItems,
  "prices": CartPrices,
  "printed_card_included": false,
  "rules": [CartRuleStorefront],
  "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": "xyz789"
}

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": "xyz789",
  "firstname": "abc123",
  "lastname": "abc123",
  "middlename": "abc123",
  "postcode": "xyz789",
  "prefix": "xyz789",
  "region": "xyz789",
  "region_id": 987,
  "save_in_address_book": true,
  "street": ["abc123"],
  "suffix": "xyz789",
  "telephone": "abc123",
  "vat_id": "abc123"
}

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.
customer_address_uid - ID
The unique ID from the customer's address book that uniquely identifies the address.
fax - String
The customer's fax number.
firstname - String!
The first name of the customer or guest.
id - Int
Id of the customer address. (Deprecated: Use `customer_address_uid` instead.)
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 - ID!
The unique id of the customer cart address.
vat_id - String
The VAT company number for billing or shipping address.

Possible Types

CartAddressInterface Types
BillingCartAddress
ShippingCartAddress

Example

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

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

CartCustomAttributesInput

Defines a cart custom attributes.

Input Fields

Input Field
Description
cart_id - String!
The cart ID.
custom_attributes - [CustomAttributeInput]
An array of custom attributes for cart.

Example

{
  "cart_id": "abc123",
  "custom_attributes": [CustomAttributeInput]
}

CartDiscountType

Values

Enum Value
Description
ITEM
SHIPPING

Example

""ITEM""

CartItemCustomAttributesInput

Defines a cart item custom attributes.

Input Fields

Input Field
Description
cart_id - String!
The cart ID.
cart_item_id - String!
The cart item ID.
custom_attributes - [CustomAttributeInput]
An array of custom attributes for cart item.

Example

{
  "cart_id": "xyz789",
  "cart_item_id": "abc123",
  "custom_attributes": [CustomAttributeInput]
}

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": 123.45,
  "selected_options": ["4"],
  "sku": "abc123"
}

CartItemInterface

An interface for products in a cart.

Fields

Field Name
Description
custom_attributes - [CustomAttribute]
The custom attributes for the cart item
discount - [Discount]
Contains discount for quote line item.
errors - [CartItemError]
An array of errors encountered while loading the cart item
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
not_available_message - String
Message to display when the product is not available with this selected option.
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. (Deprecated: Product information is part of a composable Catalog Service.)
quantity - Float!
The quantity of this item in the cart.
uid - ID!
The unique ID for a `CartItemInterface` object.

Possible Types

Example

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

CartItemPrices

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

Fields

Field Name
Description
catalog_discount - ProductDiscount
The price discount for the unit price of the item represents the difference between its regular price and final price.
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.
original_item_price - Money!
The value of the original unit price for the item, including discounts.
original_row_total - Money!
The value of the original price multiplied by the quantity of the 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_catalog_discount - ProductDiscount
The price discount multiplied by the item quantity represents the total difference between the regular price and the final price for the entire quote item.
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

{
  "catalog_discount": ProductDiscount,
  "discounts": [Discount],
  "fixed_product_taxes": [FixedProductTax],
  "original_item_price": Money,
  "original_row_total": Money,
  "price": Money,
  "price_including_tax": Money,
  "row_catalog_discount": ProductDiscount,
  "row_total": Money,
  "row_total_including_tax": Money,
  "total_item_discount": Money
}

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": "abc123",
  "value": 123.45
}

CartItemUpdateInput

A single item to be updated.

Input Fields

Input Field
Description
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_uid": 4,
  "customizable_options": [CustomizableOptionInput],
  "gift_message": GiftMessageInput,
  "gift_wrapping_id": "4",
  "quantity": 987.65
}

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.
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.
grand_total_excluding_tax - Money
The total of the cart, including discounts, shipping, and other fees without tax.
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],
  "discounts": [Discount],
  "gift_options": GiftOptionsPrices,
  "grand_total": Money,
  "grand_total_excluding_tax": Money,
  "subtotal_excluding_tax": Money,
  "subtotal_including_tax": Money,
  "subtotal_with_discount_excluding_tax": Money
}

CartRuleStorefront

Fields

Field Name
Description
uid - ID!
The unique ID for a `CartRule` object.

Example

{"uid": "4"}

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

CartUserInputError

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
COULD_NOT_FIND_CART_ITEM
REQUIRED_PARAMETER_MISSING
INVALID_PARAMETER_VALUE
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": "xyz789",
  "entity_type": "CATALOG_PRODUCT",
  "frontend_class": "abc123",
  "frontend_input": "BOOLEAN",
  "is_comparable": false,
  "is_filterable": true,
  "is_filterable_in_search": true,
  "is_html_allowed_on_front": true,
  "is_required": false,
  "is_searchable": true,
  "is_unique": true,
  "is_used_for_price_rules": true,
  "is_used_for_promo_rules": true,
  "is_visible_in_advanced_search": false,
  "is_visible_on_front": false,
  "is_wysiwyg_enabled": true,
  "label": "xyz789",
  "options": [CustomAttributeOptionInterface],
  "swatch_input_type": "BOOLEAN",
  "update_product_preview_image": true,
  "use_product_image_for_swatch": false,
  "used_in_product_listing": true
}

CategoryBucket

New category bucket for federation

Fields

Field Name
Description
count - Int!
id - ID!
path - String!
title - String!

Example

{
  "count": 123,
  "id": 4,
  "path": "abc123",
  "title": "abc123"
}

CategoryBucketInterface

Fields

Field Name
Description
id - ID!

Possible Types

CategoryBucketInterface Types
CategoryBucket

Example

{"id": "4"}

CategoryImage

Represents an image associated with a category.

Fields

Field Name
Description
url - String!
The URL where the image is hosted.
label - String
A descriptive label or alt text for the image.
roles - [String]
Standard predefined roles for the image.
customRoles - [String]
Custom roles specific to the implementation.

Example

{
  "url": "xyz789",
  "label": "abc123",
  "roles": ["xyz789"],
  "customRoles": ["abc123"]
}

CategoryInterface

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

Fields

Field Name
Description
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
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
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.
uid - ID!
The unique ID for a `CategoryInterface` object.
url_key - String
The URL key assigned to the category.
url_path - String
The URL path assigned to the category.

Possible Types

CategoryInterface Types
CategoryTree

Example

{
  "available_sort_by": ["xyz789"],
  "breadcrumbs": [Breadcrumb],
  "canonical_url": "abc123",
  "children_count": "abc123",
  "custom_layout_update_file": "xyz789",
  "default_sort_by": "xyz789",
  "description": "abc123",
  "display_mode": "xyz789",
  "filter_price_range": 123.45,
  "image": "abc123",
  "include_in_menu": 123,
  "is_anchor": 123,
  "landing_page": 123,
  "level": 987,
  "meta_description": "xyz789",
  "meta_keywords": "abc123",
  "meta_title": "abc123",
  "name": "xyz789",
  "path": "xyz789",
  "path_in_store": "xyz789",
  "position": 987,
  "product_count": 987,
  "uid": 4,
  "url_key": "abc123",
  "url_path": "abc123"
}

CategoryMetaTags

SEO metadata tags for the category.

Fields

Field Name
Description
title - String
The page title for SEO purposes.
description - String
The meta description for SEO purposes.
keywords - [String]
Keywords associated with the category for SEO.

Example

{
  "title": "abc123",
  "description": "xyz789",
  "keywords": ["xyz789"]
}

CategoryNavigationView

Represents a category optimized for navigation menus, with nested children for building navigation trees.

Fields

Field Name
Description
slug - String!
The unique URL-friendly identifier for the category.
name - String!
Category name. For example, `Electronics`, `Clothing` or `Books`.
children - [CategoryNavigationView]
The direct child categories for building nested navigation menus.

Example

{
  "slug": "abc123",
  "name": "xyz789",
  "children": [CategoryNavigationView]
}

CategoryProductView

Represents category information associated with a product, including hierarchical parent relationships.

Fields

Field Name
Description
name - String!
Category name. For example, `Electronics`, `Clothing` or `Books`.
slug - String!
The unique URL-friendly identifier for the category.
level - Int!
The level of the category. The root category is a level 1 category. For example, men -> level 1, men/clothing -> level 2, men/clothing/shorts -> level 3
parents - [CategoryProductView!]
The ancestor categories in the hierarchy, ordered from root to immediate parent.

Example

{
  "name": "abc123",
  "slug": "xyz789",
  "level": 123,
  "parents": [CategoryProductView]
}

CategoryTree

Contains the hierarchy of categories.

Fields

Field Name
Description
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
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
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.
uid - ID!
The unique ID for a `CategoryInterface` object.
url_key - String
The URL key assigned to the category.
url_path - String
The URL path assigned to the category.

Example

{
  "available_sort_by": ["xyz789"],
  "breadcrumbs": [Breadcrumb],
  "canonical_url": "abc123",
  "children_count": "xyz789",
  "custom_layout_update_file": "xyz789",
  "default_sort_by": "xyz789",
  "description": "xyz789",
  "display_mode": "xyz789",
  "filter_price_range": 123.45,
  "image": "abc123",
  "include_in_menu": 123,
  "is_anchor": 987,
  "landing_page": 987,
  "level": 987,
  "meta_description": "xyz789",
  "meta_keywords": "abc123",
  "meta_title": "abc123",
  "name": "abc123",
  "path": "abc123",
  "path_in_store": "abc123",
  "position": 123,
  "product_count": 987,
  "uid": 4,
  "url_key": "xyz789",
  "url_path": "xyz789"
}

CategoryTreeView

Represents a category within a hierarchical tree structure, including parent and children relationships.

Fields

Field Name
Description
slug - String!
The unique URL-friendly identifier for the category.
name - String!
Category name. For example, `Electronics`, `Clothing` or `Books`.
description - String
A detailed description of the category.
metaTags - CategoryMetaTags
SEO metadata tags for the category.
images - [CategoryImage]
Visual images associated with the category.
level - Int
The root category is a level 1 category. For example, men -> level 1, men/clothing -> level 2, men/clothing/shorts -> level 3
parentSlug - String
The slug of the parent category, if any.
childrenSlugs - [String]
The slugs of all direct child categories. Ex: men/clothing/shorts -> [men/clothing/shorts/athletic, men/clothing/shorts/swimwear]

Example

{
  "slug": "xyz789",
  "name": "xyz789",
  "description": "xyz789",
  "metaTags": CategoryMetaTags,
  "images": [CategoryImage],
  "level": 123,
  "parentSlug": "abc123",
  "childrenSlugs": ["xyz789"]
}

CategoryView

Represents a category. Contains information about a category, including the category ID, the category name, the category path, the category URL key, the category URL path, and the category roles.

Fields

Field Name
Description
availableSortBy - [String]
List of available sort by options. For example, `name`, `position` or `size`.
children - [String!]
List of child category IDs. For example, `123`, `456` or `789`.
defaultSortBy - String
Default sort by option. For example, `name`, `position` or `size`.
id - ID!
Category ID. For example, `123`, `456` or `789`. (Deprecated: 'CategoryView' is deprecated for use as a Bucket in 'productSearch' facet (to be removed after Sep 1, 2024). Use 'CategoryBucket' instead.)
level - Int
The level of the category. The root category is a level 1 category. For example, men -> level 1, men/clothing -> level 2, men/clothing/shorts -> level 3
name - String
Category name. For example, `Electronics`, `Clothing` or `Books`.
parentId - String!
Parent category ID. For example, `123`, `456` or `789`.
path - String
Category path. For example, `/electronics/laptops`, `/clothing/shirts` or `/books/fiction`. (Deprecated: 'CategoryView' is deprecated for use as a Bucket in 'productSearch' facet (to be removed after Sep 1, 2024). Use 'CategoryBucket' instead.)
roles - [String!]!
List of roles for the category. For example, `show_on_plp`, `show_in_pdp` or `show_in_search`.
urlKey - String
Category URL key. For example, `electronics`, `clothing` or `books`.
urlPath - String
Category URL path. For example, `/electronics/laptops`, `/clothing/shirts` or `/books/fiction`.
count - Int!
(Deprecated: 'CategoryView' is deprecated for use as a Bucket in 'productSearch' facet (to be removed after Sep 1, 2024). Use 'CategoryBucket' instead.)
title - String!
(Deprecated: 'CategoryView' is deprecated for use as a Bucket in 'productSearch' facet (to be removed after Sep 1, 2024). Use 'CategoryBucket' instead.)

Example

{
  "availableSortBy": ["abc123"],
  "children": ["xyz789"],
  "defaultSortBy": "abc123",
  "id": "4",
  "level": 123,
  "name": "abc123",
  "parentId": "xyz789",
  "path": "xyz789",
  "roles": ["xyz789"],
  "urlKey": "xyz789",
  "urlPath": "xyz789",
  "count": 987,
  "title": "xyz789"
}

CategoryViewInterface

Base interface defining essential category fields shared across all category views.

Fields

Field Name
Description
availableSortBy - [String]
List of available sort by options. For example, name, size or position.
defaultSortBy - String
Default sort by option. For example, name, size or position.
id - ID!
Category ID. For example, `123`, `456` or `789`. (Deprecated: 'CategoryView' is deprecated for use as a Bucket in 'productSearch' facet (to be removed after Sep 1, 2024). Use 'CategoryBucket' instead.)
level - Int
The level of the category. The root category is a level 1 category. For example, men -> level 1, men/clothing -> level 2, men/clothing/shorts -> level 3
name - String
Category name. For example, `Electronics`, `Clothing` or `Books`.
path - String
Category path. For example, `/electronics/laptops`, `/clothing/shirts` or `/books/fiction`.
roles - [String]
List of roles for the category. For example, `show_on_plp`, `show_in_pdp` or `show_in_search`.
urlKey - String
Category URL key. For example, `electronics`, `clothing` or `books`.
urlPath - String
Category URL path. For example, `/electronics/laptops`, `/clothing/shirts` or `/books/fiction`.

Possible Types

CategoryViewInterface Types
CategoryView

Example

{
  "availableSortBy": ["xyz789"],
  "defaultSortBy": "abc123",
  "id": 4,
  "level": 987,
  "name": "abc123",
  "path": "abc123",
  "roles": ["abc123"],
  "urlKey": "xyz789",
  "urlPath": "xyz789"
}

CategoryViewV2

Base interface defining essential category fields shared across all category views.

Fields

Field Name
Description
slug - String!
The unique URL-friendly identifier for the category.
name - String!
Category name. For example, `Electronics`, `Clothing` or `Books`.

Possible Types

Example

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

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": 123,
  "checkbox_text": "abc123",
  "content": "xyz789",
  "content_height": "abc123",
  "is_html": false,
  "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": "abc123",
  "path": ["xyz789"]
}

CheckoutUserInputErrorCodes

Values

Enum Value
Description
REORDER_NOT_AVAILABLE
PRODUCT_NOT_FOUND
NOT_SALABLE
INSUFFICIENT_STOCK
UNDEFINED

Example

""REORDER_NOT_AVAILABLE""

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

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

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

ColorSwatchData

Fields

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

Example

{"value": "abc123"}

CommerceOptimizerContext

Commerce Optimizer entities

Fields

Field Name
Description
priceBookId - ID!
The priceBookId for current customer session.

Example

{"priceBookId": 4}

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.
available_payment_methods - [AvailablePaymentMethod]
Available payment methods for the company with proper B2B configuration and company-specific filtering.
available_shipping_methods - [CompanyAvailableShippingMethod]
Available shipping carriers for the company with proper B2B configuration and company-specific filtering.
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.
custom_attributes - [CustomAttribute]
The custom attributes for the company
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.
status - CompanyStatusEnum
The current status of the company.
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],
  "available_payment_methods": [AvailablePaymentMethod],
  "available_shipping_methods": [
    CompanyAvailableShippingMethod
  ],
  "company_admin": Customer,
  "credit": CompanyCredit,
  "credit_history": CompanyCreditHistory,
  "custom_attributes": [CustomAttribute],
  "email": "xyz789",
  "id": "4",
  "legal_address": CompanyLegalAddress,
  "legal_name": "abc123",
  "name": "abc123",
  "payment_methods": ["abc123"],
  "reseller_id": "abc123",
  "role": CompanyRole,
  "roles": CompanyRoles,
  "sales_representative": CompanySalesRepresentative,
  "status": "PENDING",
  "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": "abc123"
}

CompanyAdminInput

Defines the input schema for creating a company administrator.

Input Fields

Input Field
Description
custom_attributes - [AttributeValueInput]
The company administrator's custom attributes.
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.
telephone - String
The phone number of the company administrator.

Example

{
  "custom_attributes": [AttributeValueInput],
  "email": "xyz789",
  "firstname": "xyz789",
  "gender": 987,
  "job_title": "abc123",
  "lastname": "abc123",
  "telephone": "abc123"
}

CompanyAvailableShippingMethod

Describes a carrier-level shipping option available to the company.

Fields

Field Name
Description
code - String!
title - String!

Example

{
  "code": "xyz789",
  "title": "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.
status - CompanyStatusEnum
The current status of the company.

Example

{
  "id": "4",
  "legal_name": "xyz789",
  "name": "xyz789",
  "status": "PENDING"
}

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": "xyz789",
  "reseller_id": "xyz789",
  "vat_tax_id": "xyz789"
}

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.
exceed_limit - Boolean!
Indicates whether company credit functionality is allowed to exceed current company credit limit.
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,
  "exceed_limit": false,
  "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": 123
}

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": "abc123",
  "date": "abc123",
  "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": "abc123",
  "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": "xyz789",
  "country_code": "AF",
  "postcode": "abc123",
  "region": CustomerAddressRegion,
  "street": ["abc123"],
  "telephone": "xyz789"
}

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": ["abc123"],
  "telephone": "abc123"
}

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": "xyz789",
  "country_id": "AF",
  "postcode": "abc123",
  "region": CustomerAddressRegionInput,
  "street": ["xyz789"],
  "telephone": "abc123"
}

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": "abc123",
  "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": ["abc123"]
}

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": "xyz789",
  "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": 987
}

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": "xyz789",
  "lastname": "xyz789"
}

CompanyStatusEnum

Defines the list of company status values.

Values

Enum Value
Description
PENDING
Company is pending approval.
APPROVED
Company is approved.
REJECTED
Company is rejected.
BLOCKED
Company is blocked.

Example

""PENDING""

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": "abc123",
  "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": "xyz789",
  "id": "4",
  "name": "xyz789"
}

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": "xyz789",
  "company_name": "abc123",
  "legal_address": CompanyLegalAddressUpdateInput,
  "legal_name": "abc123",
  "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": "abc123",
  "firstname": "abc123",
  "job_title": "abc123",
  "lastname": "xyz789",
  "role_id": "4",
  "status": "ACTIVE",
  "target_id": 4,
  "telephone": "xyz789"
}

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": "abc123",
  "firstname": "abc123",
  "id": "4",
  "job_title": "xyz789",
  "lastname": "xyz789",
  "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": "xyz789",
  "label": "xyz789"
}

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. (Deprecated: Product information is part of a composable Catalog Service.)
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": 123,
  "items": [ComparableItem],
  "uid": "4"
}

CompleteOrderInput

Update the quote and complete the order

Input Fields

Input Field
Description
cartId - String!
The customer cart ID
id - String!
PayPal order ID

Example

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

ComplexProductView

Represents all product types, except simple products. Complex product prices are returned as a price range, because price values can vary based on selected options.

Fields

Field Name
Description
addToCartAllowed - Boolean
A flag stating if the product can be added to cart (Deprecated: This field is deprecated and will be removed.)
inStock - Boolean
A flag stating if the product is in stock (Deprecated: This field is deprecated and will be removed.)
lowStock - Boolean
Indicates whether the remaining quantity of the product has reached the Only X Left threshold. (Deprecated: This field is deprecated and will be removed.)
attributes - [ProductViewAttribute]
A list of merchant-defined attributes designated for the storefront. They can be filtered by roles and names.
description - String
The detailed description of the product.
id - ID!
The product ID, generated as a composite key, unique per locale.
images - [ProductViewImage]
A list of images defined for the product. Possible values include `image`, `small_image` or `swatch`.
videos - [ProductViewVideo]
A list of videos defined for the product.
lastModifiedAt - DateTime
Date and time when the product was last updated.
metaDescription - String
A brief overview of the product for search results listings.
metaKeyword - String
A comma-separated list of keywords that are visible only to search engines.
metaTitle - String
A string that is displayed in the title bar and tab of the browser and in search results lists.
name - String
Product name.
inputOptions - [ProductViewInputOption]
A list of input options. (Deprecated: This field is deprecated and will be removed.)
options - [ProductViewOption]
A list of selectable options.
priceRange - ProductViewPriceRange
A range of possible prices for a complex product.
shortDescription - String
A summary of the product.
sku - String
A unique code used for identification of a product.
externalId - String
External Id (Deprecated: This field is deprecated and will be removed.)
url - String
Canonical URL of the product. (Deprecated: This field is deprecated and will be removed.)
urlKey - String
The URL key of the product.
links - [ProductViewLink]
A list of product links. Links are used to navigate from one product to another.
categories - [CategoryProductView!]
A list of categories in which the product is present.
queryType - String
Indicates if the product was retrieved from the primary or the backup query
visibility - String
Visibility setting of the product

Example

{
  "addToCartAllowed": true,
  "inStock": false,
  "lowStock": true,
  "attributes": [ProductViewAttribute],
  "description": "abc123",
  "id": 4,
  "images": [ProductViewImage],
  "videos": [ProductViewVideo],
  "lastModifiedAt": "2007-12-03T10:15:30Z",
  "metaDescription": "xyz789",
  "metaKeyword": "xyz789",
  "metaTitle": "xyz789",
  "name": "xyz789",
  "inputOptions": [ProductViewInputOption],
  "options": [ProductViewOption],
  "priceRange": ProductViewPriceRange,
  "shortDescription": "xyz789",
  "sku": "xyz789",
  "externalId": "abc123",
  "url": "abc123",
  "urlKey": "abc123",
  "links": [ProductViewLink],
  "categories": [CategoryProductView],
  "queryType": "xyz789",
  "visibility": "abc123"
}

ComplexTextValue

Fields

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

Example

{"html": "xyz789"}

ConditionInput

Input Fields

Input Field
Description
field - Field
operator - OperatorInput
enabled - Boolean

Example

{
  "field": "UNKNOWN_FIELD",
  "operator": OperatorInput,
  "enabled": true
}

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

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.
custom_attributes - [CustomAttribute]
The custom attributes for 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.
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
not_available_message - String
Message to display when the product is not available with this selected option.
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. (Deprecated: Product information is part of a composable Catalog Service.)
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,
  "custom_attributes": [CustomAttribute],
  "customizable_options": [SelectedCustomizableOption],
  "discount": [Discount],
  "errors": [CartItemError],
  "gift_message": GiftMessage,
  "gift_wrapping": GiftWrapping,
  "is_available": false,
  "max_qty": 123.45,
  "min_qty": 123.45,
  "not_available_message": "abc123",
  "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]
}

ConfigurableOrderItem

Fields

Field Name
Description
custom_attributes - [CustomAttribute]
The custom attributes for the order item
discounts - [Discount]
The final discount information for the 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.
parent_sku - String
The SKU of parent product.
prices - OrderItemPrices
Contains details about the price of the item, including taxes and discounts.
product - ProductInterface
The ProductInterface object, which contains details about the base product (Deprecated: Product information is part of a composable Catalog Service.)
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_return_requested - Float
The requested return quantity of the item.
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

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

ConfigurableProduct

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

Fields

Field Name
Description
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.
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.
crosssell_products - [ProductInterface]
Crosssell Products
custom_attributesV2 - ProductCustomAttributes
Product custom attributes.
description - ComplexTextValue
Detailed information about the product. The value can include simple HTML tags.
gift_message_available - Boolean!
Returns a value indicating gift message availability for the product.
gift_wrapping_available - Boolean!
Returns a value indicating gift wrapping availability for the product.
gift_wrapping_price - Money
Returns value and currency indicating gift wrapping price for the product.
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.
max_sale_qty - Float
Maximum Qty Allowed in Shopping Cart
media_gallery - [MediaGalleryInterface]
An array of media gallery objects.
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.
min_sale_qty - Float
Minimum Qty Allowed in Shopping Cart
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_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.
quantity - Float
Quantity of available stock
related_products - [ProductInterface]
An array of products to be displayed in a Related Products block.
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_price - Float
The discounted price of the product.
special_to_date - String
The end date for a product with a special price.
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.
uid - ID!
The unique ID for a `ProductInterface` object.
upsell_products - [ProductInterface]
Upsell Products
url_key - String
The part of the URL that identifies the product
variants - [ConfigurableVariant]
An array of simple product variants.
weight - Float
The weight of the item, in units defined by the store.

Example

{
  "canonical_url": "xyz789",
  "categories": [CategoryInterface],
  "configurable_options": [ConfigurableProductOptions],
  "configurable_product_options_selection": ConfigurableProductOptionsSelection,
  "country_of_manufacture": "xyz789",
  "crosssell_products": [ProductInterface],
  "custom_attributesV2": ProductCustomAttributes,
  "description": ComplexTextValue,
  "gift_message_available": true,
  "gift_wrapping_available": false,
  "gift_wrapping_price": Money,
  "image": ProductImage,
  "is_returnable": "xyz789",
  "manufacturer": 987,
  "max_sale_qty": 123.45,
  "media_gallery": [MediaGalleryInterface],
  "meta_description": "abc123",
  "meta_keyword": "xyz789",
  "meta_title": "abc123",
  "min_sale_qty": 987.65,
  "name": "xyz789",
  "new_from_date": "xyz789",
  "new_to_date": "abc123",
  "only_x_left_in_stock": 123.45,
  "options": [CustomizableOptionInterface],
  "options_container": "xyz789",
  "price_range": PriceRange,
  "price_tiers": [TierPrice],
  "product_links": [ProductLinksInterface],
  "quantity": 123.45,
  "related_products": [ProductInterface],
  "short_description": ComplexTextValue,
  "sku": "abc123",
  "small_image": ProductImage,
  "special_price": 123.45,
  "special_to_date": "xyz789",
  "stock_status": "IN_STOCK",
  "swatch_image": "abc123",
  "thumbnail": ProductImage,
  "uid": 4,
  "upsell_products": [ProductInterface],
  "url_key": "abc123",
  "variants": [ConfigurableVariant],
  "weight": 987.65
}

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": "xyz789",
  "label": "abc123",
  "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": true,
  "label": "abc123",
  "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_uid - ID!
The unique ID for an `Attribute` object.
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.
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": "xyz789",
  "attribute_uid": 4,
  "label": "abc123",
  "position": 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.

Example

{
  "default_label": "xyz789",
  "label": "xyz789",
  "store_label": "xyz789",
  "swatch_data": SwatchDataInterface,
  "uid": "4",
  "use_default_value": true
}

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.
sku - String!
The product SKU.
uid - ID!
The unique ID of an item in a requisition list.

Example

{
  "configurable_options": [SelectedConfigurableOption],
  "customizable_options": [SelectedCustomizableOption],
  "product": ProductInterface,
  "quantity": 987.65,
  "sku": "xyz789",
  "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.
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. (Deprecated: Product information is part of a composable Catalog Service.)
quantity - Float!
The quantity of this wish list item.

Example

{
  "added_at": "abc123",
  "configurable_options": [SelectedConfigurableOption],
  "configured_variant": ProductInterface,
  "customizable_options": [SelectedCustomizableOption],
  "description": "abc123",
  "id": "4",
  "product": ProductInterface,
  "quantity": 123.45
}

ConfirmCancelOrderInput

Input Fields

Input Field
Description
confirmation_key - String!
Confirmation Key to cancel the order.
order_id - ID!
The unique ID of an `Order` type.

Example

{
  "confirmation_key": "xyz789",
  "order_id": "4"
}

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

ConfirmReturnInput

Input Fields

Input Field
Description
confirmation_key - String!
Confirmation Key to return order.
order_id - ID!
The unique ID of an `Order` type.

Example

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

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

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": "xyz789",
  "full_name_locale": "abc123",
  "id": "xyz789",
  "three_letter_abbreviation": "abc123",
  "two_letter_abbreviation": "xyz789"
}

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": "abc123",
  "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}

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": "abc123",
  "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": "xyz789",
  "id": "abc123",
  "mp_order_id": "abc123",
  "status": "xyz789"
}

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

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}

CreateVaultCardPaymentTokenInput

Describe the variables needed to create a vault payment token

Input Fields

Input Field
Description
card_description - String
Description of the vaulted card
setup_token_id - String!
The setup token obtained by the createVaultCardSetupToken endpoint

Example

{
  "card_description": "xyz789",
  "setup_token_id": "xyz789"
}

CreateVaultCardPaymentTokenOutput

The vault token id and information about the payment source

Fields

Field Name
Description
payment_source - PaymentSourceOutput!
The payment source information
vault_token_id - String!
The vault payment token information

Example

{
  "payment_source": PaymentSourceOutput,
  "vault_token_id": "xyz789"
}

CreateVaultCardSetupTokenInput

Describe the variables needed to create a vault card setup token

Input Fields

Input Field
Description
setup_token - VaultSetupTokenInput!
The setup token information
three_ds_mode - ThreeDSMode
The 3DS mode

Example

{
  "setup_token": VaultSetupTokenInput,
  "three_ds_mode": "OFF"
}

CreateVaultCardSetupTokenOutput

The setup token id information

Fields

Field Name
Description
setup_token - String!
The setup token id

Example

{"setup_token": "xyz789"}

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": "abc123", "visibility": "PUBLIC"}

CreateWishlistOutput

Contains the wish list.

Fields

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

Example

{"wishlist": Wishlist}

CreditMemo

Contains credit memo details.

Fields

Field Name
Description
comments - [SalesCommentItem]
Comments on the credit memo.
custom_attributes - [CustomAttribute]
The custom attributes for 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],
  "custom_attributes": [CustomAttribute],
  "id": 4,
  "items": [CreditMemoItemInterface],
  "number": "xyz789",
  "total": CreditMemoTotal
}

CreditMemoCustomAttributesInput

Defines a credit memo item's custom attributes.

Input Fields

Input Field
Description
credit_memo_id - String!
The credit memo ID.
custom_attributes - [CustomAttributeInput]
An array of custom attributes for the credit memo.

Example

{
  "credit_memo_id": "abc123",
  "custom_attributes": [CustomAttributeInput]
}

CreditMemoItem

Fields

Field Name
Description
custom_attributes - [CustomAttribute]
The custom attributes for the credit memo item
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

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

CreditMemoItemCustomAttributesInput

Defines a credit memo's custom attributes.

Input Fields

Input Field
Description
credit_memo_id - String!
The credit memo ID.
credit_memo_item_id - String!
The credit memo item ID.
custom_attributes - [CustomAttributeInput]
An array of custom attributes for the credit memo item.

Example

{
  "credit_memo_id": "xyz789",
  "credit_memo_item_id": "xyz789",
  "custom_attributes": [CustomAttributeInput]
}

CreditMemoItemInterface

Credit memo item details.

Fields

Field Name
Description
custom_attributes - [CustomAttribute]
The custom attributes for the credit memo item
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

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

CreditMemoOutput

Contains details about the credit memo after adding custom attributes to it.

Fields

Field Name
Description
credit_memo - CreditMemo!
The custom attributes to credit memo have been added.

Example

{"credit_memo": CreditMemo}

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_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": "xyz789",
  "base_currency_symbol": "xyz789",
  "default_display_currency_code": "abc123",
  "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
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""

CustomAttribute

Specifies the custom attribute code and value.

Fields

Field Name
Description
attribute_code - String
The custom attribute code.
value - String
The custom attribute code value.

Example

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

CustomAttributeInput

Defines a custom attribute.

Input Fields

Input Field
Description
attribute_code - String!
Attribute Code.
value - String!
Attribute Value.

Example

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

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": "abc123",
  "entity_type": "CATALOG_PRODUCT",
  "frontend_class": "xyz789",
  "frontend_input": "BOOLEAN",
  "is_required": false,
  "is_unique": false,
  "label": "abc123",
  "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": true,
  "label": "xyz789",
  "value": "abc123"
}

CustomConfigKeyValue

A simple key value object.

Fields

Field Name
Description
key - String
value - String

Example

{
  "key": "abc123",
  "value": "abc123"
}