NegotiableQuoteTemplateHistoryEntry

Contains details about a change for a negotiable quote template.

Fields

Field Name
Description
author - NegotiableQuoteUser!
The person who made a change in the status of the negotiable quote.
change_type - NegotiableQuoteHistoryEntryChangeType!
An enum that specifies the reason for a status change in the negotiable quote history entry.
changes - NegotiableQuoteTemplateHistoryChanges
The set of changes in the negotiable quote template.
created_at - String!
Timestamp indicating when the negotiable quote entry was created.
uid - ID!
The unique ID of a `NegotiableQuoteHistoryEntry` object.

Example

{
  "author": NegotiableQuoteUser,
  "change_type": "CREATED",
  "changes": NegotiableQuoteTemplateHistoryChanges,
  "created_at": "abc123",
  "uid": "4"
}

NegotiableQuoteTemplateHistoryStatusChange

Lists a new status change applied to a negotiable quote template and the previous status.

Fields

Field Name
Description
new_status - String!
The updated status.
old_status - String
The previous status. The value will be null for the first history entry in a negotiable quote.

Example

{
  "new_status": "xyz789",
  "old_status": "xyz789"
}

NegotiableQuoteTemplateHistoryStatusesChange

Contains a list of status changes that occurred for the negotiable quote template.

Fields

Field Name
Description
changes - [NegotiableQuoteTemplateHistoryStatusChange]!
A list of status changes.

Example

{"changes": [NegotiableQuoteTemplateHistoryStatusChange]}

NegotiableQuoteTemplateItemQuantityInput

Specifies the updated quantity of an item.

Input Fields

Input Field
Description
item_id - ID!
The unique ID of a `CartItemInterface` object.
max_qty - Float
The new max quantity of the negotiable quote template item. Only used if is_min_max_qty_used is true on the template.
min_qty - Float
The new min quantity of the negotiable quote template item. Only used if is_min_max_qty_used is true on the template.
quantity - Float!
The new quantity of the negotiable quote item.

Example

{
  "item_id": "4",
  "max_qty": 987.65,
  "min_qty": 987.65,
  "quantity": 123.45
}

NegotiableQuoteTemplateReferenceDocumentLinkInput

Defines the reference document link to add to a negotiable quote template.

Input Fields

Input Field
Description
document_identifier - String
The identifier of the reference document.
document_name - String!
The title of the reference document.
link_id - ID
The unique ID of a `NegotiableQuoteReferenceDocumentLink` object.
reference_document_url - String!
The URL of the reference document.

Example

{
  "document_identifier": "abc123",
  "document_name": "xyz789",
  "link_id": 4,
  "reference_document_url": "abc123"
}

NegotiableQuoteTemplateShippingAddressInput

Defines shipping addresses for the negotiable quote template.

Input Fields

Input Field
Description
address - NegotiableQuoteAddressInput
A shipping address.
customer_address_uid - ID
An ID from the company user's address book that uniquely identifies the address to be used for shipping.
customer_notes - String
Text provided by the company user.

Example

{
  "address": NegotiableQuoteAddressInput,
  "customer_address_uid": 4,
  "customer_notes": "abc123"
}

NegotiableQuoteTemplateSortInput

Defines the field to use to sort a list of negotiable quotes.

Input Fields

Input Field
Description
sort_direction - SortEnum!
Whether to return results in ascending or descending order.
sort_field - NegotiableQuoteTemplateSortableField!
The specified sort field.

Example

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

NegotiableQuoteTemplateSortableField

Values

Enum Value
Description
TEMPLATE_ID
Sorts negotiable quote templates by template id.
LAST_SHARED_AT
Sorts negotiable quote templates by the date they were last shared.

Example

""TEMPLATE_ID""

NegotiableQuoteTemplatesOutput

Contains a list of negotiable templates that match the specified filter.

Fields

Field Name
Description
items - [NegotiableQuoteTemplateGridItem]!
A list of negotiable quote templates
page_info - SearchResultPageInfo!
Contains pagination metadata
sort_fields - SortFields
Contains the default sort field and all available sort fields.
total_count - Int!
The number of negotiable quote templates returned

Example

{
  "items": [NegotiableQuoteTemplateGridItem],
  "page_info": SearchResultPageInfo,
  "sort_fields": SortFields,
  "total_count": 987
}

NegotiableQuoteUidNonFatalResultInterface

Fields

Field Name
Description
quote_uid - ID!
The unique ID of a `NegotiableQuote` object.

Possible Types

NegotiableQuoteUidNonFatalResultInterface Types
NegotiableQuoteUidOperationSuccess

Example

{"quote_uid": "4"}

NegotiableQuoteUidOperationSuccess

Contains details about a successful operation on a negotiable quote.

Fields

Field Name
Description
quote_uid - ID!
The unique ID of a `NegotiableQuote` object.

Example

{"quote_uid": 4}

NegotiableQuoteUser

A limited view of a Buyer or Seller in the negotiable quote process.

Fields

Field Name
Description
firstname - String!
The first name of the buyer or seller making a change.
lastname - String!
The buyer's or seller's last name.

Example

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

NegotiableQuotesOutput

Contains a list of negotiable that match the specified filter.

Fields

Field Name
Description
items - [NegotiableQuote]!
A list of negotiable quotes
page_info - SearchResultPageInfo!
Contains pagination metadata
sort_fields - SortFields
Contains the default sort field and all available sort fields.
total_count - Int!
The number of negotiable quotes returned

Example

{
  "items": [NegotiableQuote],
  "page_info": SearchResultPageInfo,
  "sort_fields": SortFields,
  "total_count": 987
}

NoSuchEntityUidError

Contains an error message when an invalid UID was specified.

Fields

Field Name
Description
message - String!
The returned error message.
uid - ID!
The specified invalid unique ID of an object.

Example

{
  "message": "xyz789",
  "uid": "4"
}

NumericOperatorInput

Input Fields

Input Field
Description
type - NumericOperatorType

Example

{"type": "UNKNOWN_NUMERIC_OPERATOR"}

NumericOperatorType

Values

Enum Value
Description
UNKNOWN_NUMERIC_OPERATOR
GREATER_THAN_CURRENT
LESS_THAN_CURRENT

Example

""UNKNOWN_NUMERIC_OPERATOR""

OopePaymentMethodConfig

Fields

Field Name
Description
backend_integration_url - String!
The backend URL to dispatch requests related to the payment method.
custom_config - [CustomConfigKeyValue]!
Custom config key values.

Example

{
  "backend_integration_url": "abc123",
  "custom_config": [CustomConfigKeyValue]
}

OpenNegotiableQuoteTemplateInput

Specifies the quote template id to open quote template.

Input Fields

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

Example

{"template_id": "4"}

OperatorInput

Input Fields

Input Field
Description
rangeOperator - RangeOperatorInput
customOperator - CustomOperatorInput
isOperator - IsOperatorInput
numericOperator - NumericOperatorInput
stringOperator - StringOperatorInput

Example

{
  "rangeOperator": RangeOperatorInput,
  "customOperator": CustomOperatorInput,
  "isOperator": IsOperatorInput,
  "numericOperator": NumericOperatorInput,
  "stringOperator": StringOperatorInput
}

Order

Contains the order ID.

Fields

Field Name
Description
order_number - String!
The unique ID for an `Order` object.

Example

{"order_number": "abc123"}

OrderActionType

The list of available order actions.

Values

Enum Value
Description
REORDER
CANCEL
RETURN

Example

""REORDER""

OrderAddress

Contains detailed information about an order's billing and shipping addresses.

Fields

Field Name
Description
city - String!
The city or town.
company - String
The customer's company.
country_code - CountryCodeEnum
The customer's country.
custom_attributesV2 - [AttributeValueInterface]!
Custom attributes assigned to the customer address.
fax - String
The fax number.
firstname - String!
The first name of the person associated with the shipping/billing address.
lastname - String!
The family name of the person associated with the shipping/billing address.
middlename - String
The middle name of the person associated with the shipping/billing address.
postcode - String
The customer's ZIP or postal code.
prefix - String
An honorific, such as Dr., Mr., or Mrs.
region - String
The state or province name.
region_id - ID
The unique ID for a `Region` object of a pre-defined region.
street - [String]!
An array of strings that define the street number and name.
suffix - String
A value such as Sr., Jr., or III.
telephone - String
The telephone number.
vat_id - String
The customer's Value-added tax (VAT) number (for corporate customers).

Example

{
  "city": "abc123",
  "company": "xyz789",
  "country_code": "AF",
  "custom_attributesV2": [AttributeValueInterface],
  "fax": "abc123",
  "firstname": "abc123",
  "lastname": "abc123",
  "middlename": "abc123",
  "postcode": "xyz789",
  "prefix": "abc123",
  "region": "xyz789",
  "region_id": "4",
  "street": ["abc123"],
  "suffix": "abc123",
  "telephone": "abc123",
  "vat_id": "abc123"
}

OrderCustomerInfo

Fields

Field Name
Description
firstname - String!
First name of the customer
lastname - String
Last name of the customer
middlename - String
Middle name of the customer
prefix - String
Prefix of the customer
suffix - String
Suffix of the customer

Example

{
  "firstname": "abc123",
  "lastname": "abc123",
  "middlename": "xyz789",
  "prefix": "abc123",
  "suffix": "abc123"
}

OrderItem

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.
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,
  "prices": OrderItemPrices,
  "product": ProductInterface,
  "product_name": "abc123",
  "product_sale_price": Money,
  "product_sku": "abc123",
  "product_type": "abc123",
  "product_url_key": "abc123",
  "quantity_canceled": 987.65,
  "quantity_invoiced": 123.45,
  "quantity_ordered": 987.65,
  "quantity_refunded": 987.65,
  "quantity_return_requested": 987.65,
  "quantity_returned": 123.45,
  "quantity_shipped": 123.45,
  "selected_options": [OrderItemOption],
  "status": "xyz789"
}

OrderItemInterface

Order item details.

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

Possible Types

Example

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

OrderItemOption

Represents order item options like selected or entered.

Fields

Field Name
Description
label - String!
The name of the option.
value - String!
The value of the option.

Example

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

OrderItemPrices

Fields

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

Example

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

OrderPaymentMethod

Contains details about the payment method used to pay for the order.

Fields

Field Name
Description
additional_data - [KeyValue]
Additional data per payment method type.
name - String!
The label that describes the payment method.
type - String!
The payment method code that indicates how the order was paid for.

Example

{
  "additional_data": [KeyValue],
  "name": "abc123",
  "type": "xyz789"
}

OrderShipment

Contains order shipment details.

Fields

Field Name
Description
comments - [SalesCommentItem]
Comments added to the shipment.
id - ID!
The unique ID for a `OrderShipment` object.
items - [ShipmentItemInterface]
An array of items included in the shipment.
number - String!
The sequential credit shipment number.
tracking - [ShipmentTracking]
An array of shipment tracking details.

Example

{
  "comments": [SalesCommentItem],
  "id": 4,
  "items": [ShipmentItemInterface],
  "number": "abc123",
  "tracking": [ShipmentTracking]
}

OrderTokenInput

Input to retrieve an order based on token.

Input Fields

Input Field
Description
token - String!
Order token.

Example

{"token": "abc123"}

OrderTotal

Contains details about the sales total amounts used to calculate the final price.

Fields

Field Name
Description
base_grand_total - Money!
The final base grand total amount in the base currency.
discounts - [Discount]
The applied discounts to the order.
gift_options - GiftOptionsPrices
grand_total - Money!
The final total amount, including shipping, discounts, and taxes.
grand_total_excl_tax - Money!
The grand total of the order, excluding taxes.
shipping_handling - ShippingHandling
Details about the shipping and handling costs for the order.
subtotal_excl_tax - Money!
The subtotal of the order, excluding taxes.
subtotal_incl_tax - Money!
The subtotal of the order, including taxes.
taxes - [TaxItem]
The order tax details.
total_giftcard - Money
The gift card balance applied to the order.
total_reward_points - Money
The total reward points applied to the order.
total_shipping - Money!
The shipping amount for the order.
total_store_credit - Money
The total store credit applied to the order.
total_tax - Money!
The amount of tax applied to the order.

Example

{
  "base_grand_total": Money,
  "discounts": [Discount],
  "gift_options": GiftOptionsPrices,
  "grand_total": Money,
  "grand_total_excl_tax": Money,
  "shipping_handling": ShippingHandling,
  "subtotal_excl_tax": Money,
  "subtotal_incl_tax": Money,
  "taxes": [TaxItem],
  "total_giftcard": Money,
  "total_reward_points": Money,
  "total_shipping": Money,
  "total_store_credit": Money,
  "total_tax": Money
}

PageInfo

Provides pagination information for navigating through paginated result sets.

Fields

Field Name
Description
currentPage - Int!
The current page number (1-based indexing).
pageSize - Int!
The number of items per page.
totalPages - Int!
The total number of pages available.

Example

{"currentPage": 987, "pageSize": 987, "totalPages": 123}

PageType

Type of page on which recommendations are requested

Values

Enum Value
Description
CMS
Cart
Category
(Deprecated: This field is deprecated and will be removed.)
Checkout
PageBuilder
Product

Example

""CMS""

PaymentAttributeInput

Defines the payment attribute.

Input Fields

Input Field
Description
key - String!
The code of the attribute.
value - String!
The value of the attribute.

Example

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

PaymentConfigItem

Contains payment fields that are common to all types of payment methods.

Fields

Field Name
Description
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
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

Possible Types

Example

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

PaymentConfigOutput

Retrieves the payment configuration for a given location

Fields

Field Name
Description
apple_pay - ApplePayConfig
ApplePay payment method configuration
fastlane - FastlaneConfig
Fastlane payment method configuration
google_pay - GooglePayConfig
GooglePay payment method configuration
hosted_fields - HostedFieldsConfig
Hosted fields payment method configuration
smart_buttons - SmartButtonsConfig
Smart Buttons payment method configuration

Example

{
  "apple_pay": ApplePayConfig,
  "fastlane": FastlaneConfig,
  "google_pay": GooglePayConfig,
  "hosted_fields": HostedFieldsConfig,
  "smart_buttons": SmartButtonsConfig
}

PaymentLocation

Defines the origin location for that payment request

Values

Enum Value
Description
PRODUCT_DETAIL
MINICART
CART
CHECKOUT
ADMIN

Example

""PRODUCT_DETAIL""

PaymentMethodInput

Defines the payment method.

Input Fields

Input Field
Description
additional_data - [PaymentAttributeInput]
Additional data related to the payment method.
code - String!
The internal name for the payment method.
payment_services_paypal_apple_pay - ApplePayMethodInput
Required input for Apple Pay button
payment_services_paypal_fastlane - FastlaneMethodInput
Required input for fastlane
payment_services_paypal_google_pay - GooglePayMethodInput
Required input for Google Pay button
payment_services_paypal_hosted_fields - HostedFieldsInput
Required input for Hosted Fields
payment_services_paypal_smart_buttons - SmartButtonMethodInput
Required input for Smart buttons
payment_services_paypal_vault - VaultMethodInput
Required input for vault
purchase_order_number - String
The purchase order number. Optional for most payment methods.

Example

{
  "additional_data": [PaymentAttributeInput],
  "code": "xyz789",
  "payment_services_paypal_apple_pay": ApplePayMethodInput,
  "payment_services_paypal_fastlane": FastlaneMethodInput,
  "payment_services_paypal_google_pay": GooglePayMethodInput,
  "payment_services_paypal_hosted_fields": HostedFieldsInput,
  "payment_services_paypal_smart_buttons": SmartButtonMethodInput,
  "payment_services_paypal_vault": VaultMethodInput,
  "purchase_order_number": "xyz789"
}

PaymentOrderOutput

Contains the payment order details

Fields

Field Name
Description
id - String
PayPal order ID
mp_order_id - String
The order ID generated by Payment Services
payment_source_details - PaymentSourceDetails
Details about the card used on the order
status - String
The status of the payment order

Example

{
  "id": "abc123",
  "mp_order_id": "abc123",
  "payment_source_details": PaymentSourceDetails,
  "status": "abc123"
}

PaymentSDKParamsItem

Fields

Field Name
Description
code - String
The payment method code used in the order
params - [SDKParams]
The payment SDK parameters

Example

{
  "code": "xyz789",
  "params": [SDKParams]
}

PaymentSourceDetails

Fields

Field Name
Description
card - Card
Details about the card used on the order

Example

{"card": Card}

PaymentSourceInput

The payment source information

Input Fields

Input Field
Description
card - CardPaymentSourceInput!
The card payment source information

Example

{"card": CardPaymentSourceInput}

PaymentSourceOutput

The payment source information

Fields

Field Name
Description
card - CardPaymentSourceOutput!
The card payment source information

Example

{"card": CardPaymentSourceOutput}

PaymentToken

The stored payment method available to the customer.

Fields

Field Name
Description
details - String
A description of the stored account details.
payment_method_code - String!
The payment method code associated with the token.
public_hash - String!
The public hash of the token.
type - PaymentTokenTypeEnum!
Specifies the payment token type.

Example

{
  "details": "abc123",
  "payment_method_code": "xyz789",
  "public_hash": "xyz789",
  "type": "card"
}

PaymentTokenTypeEnum

The list of available payment token types.

Values

Enum Value
Description
card
phpcs:ignore Magento2.GraphQL.ValidArgumentName
account
phpcs:ignore Magento2.GraphQL.ValidArgumentName

Example

""card""

PhysicalProductInterface

Contains attributes specific to tangible products.

Fields

Field Name
Description
weight - Float
The weight of the item, in units defined by the store.

Possible Types

Example

{"weight": 987.65}

PickupLocation

Defines Pickup Location information.

Fields

Field Name
Description
city - String
contact_name - String
country_id - String
description - String
email - String
fax - String
latitude - Float
longitude - Float
name - String
phone - String
pickup_location_code - String
postcode - String
region - String
region_id - Int
street - String

Example

{
  "city": "xyz789",
  "contact_name": "xyz789",
  "country_id": "abc123",
  "description": "xyz789",
  "email": "xyz789",
  "fax": "xyz789",
  "latitude": 123.45,
  "longitude": 123.45,
  "name": "xyz789",
  "phone": "xyz789",
  "pickup_location_code": "abc123",
  "postcode": "xyz789",
  "region": "abc123",
  "region_id": 987,
  "street": "xyz789"
}

PickupLocationFilterInput

PickupLocationFilterInput defines the list of attributes and filters for the search.

Input Fields

Input Field
Description
city - FilterTypeInput
Filter by city.
country_id - FilterTypeInput
Filter by country.
name - FilterTypeInput
Filter by pickup location name.
pickup_location_code - FilterTypeInput
Filter by pickup location code.
postcode - FilterTypeInput
Filter by postcode.
region - FilterTypeInput
Filter by region.
region_id - FilterTypeInput
Filter by region id.
street - FilterTypeInput
Filter by street.

Example

{
  "city": FilterTypeInput,
  "country_id": FilterTypeInput,
  "name": FilterTypeInput,
  "pickup_location_code": FilterTypeInput,
  "postcode": FilterTypeInput,
  "region": FilterTypeInput,
  "region_id": FilterTypeInput,
  "street": FilterTypeInput
}

PickupLocationSortInput

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

Input Fields

Input Field
Description
city - SortEnum
City where pickup location is placed.
contact_name - SortEnum
Name of the contact person.
country_id - SortEnum
Id of the country in two letters.
description - SortEnum
Description of the pickup location.
distance - SortEnum
Distance to the address, requested by distance filter. Applicable only with distance filter. If distance sort order is present, all other sort orders will be ignored.
email - SortEnum
Contact email of the pickup location.
fax - SortEnum
Contact fax of the pickup location.
latitude - SortEnum
Geographic latitude where pickup location is placed.
longitude - SortEnum
Geographic longitude where pickup location is placed.
name - SortEnum
The pickup location name. Customer use this to identify the pickup location.
phone - SortEnum
Contact phone number of the pickup location.
pickup_location_code - SortEnum
A code assigned to pickup location to identify the source.
postcode - SortEnum
Postcode where pickup location is placed.
region - SortEnum
Name of the region.
region_id - SortEnum
Id of the region.
street - SortEnum
Street where pickup location is placed.

Example

{
  "city": "ASC",
  "contact_name": "ASC",
  "country_id": "ASC",
  "description": "ASC",
  "distance": "ASC",
  "email": "ASC",
  "fax": "ASC",
  "latitude": "ASC",
  "longitude": "ASC",
  "name": "ASC",
  "phone": "ASC",
  "pickup_location_code": "ASC",
  "postcode": "ASC",
  "region": "ASC",
  "region_id": "ASC",
  "street": "ASC"
}

PickupLocations

Top level object returned in a pickup locations search.

Fields

Field Name
Description
items - [PickupLocation]
An array of pickup locations that match the specific search request.
page_info - SearchResultPageInfo
An object that includes the page_info and currentPage values specified in the query.
total_count - Int
The number of products returned.

Example

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

PlaceNegotiableQuoteOrderInput

Specifies the negotiable quote to convert to an order.

Input Fields

Input Field
Description
quote_uid - ID!
The unique ID of a `NegotiableQuote` object.

Example

{"quote_uid": 4}

PlaceNegotiableQuoteOrderOutput

An output object that returns the generated order.

Fields

Field Name
Description
order - Order!
Contains the generated order number.

Example

{"order": Order}

PlaceNegotiableQuoteOrderOutputV2

An output object that returns the generated order.

Fields

Field Name
Description
errors - [PlaceOrderError]
An array of place negotiable quote order errors.
order - CustomerOrder
Full order information.

Example

{
  "errors": [PlaceOrderError],
  "order": CustomerOrder
}

PlaceOrderError

An error encountered while placing an order.

Fields

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

Example

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

PlaceOrderErrorCodes

Values

Enum Value
Description
CART_NOT_FOUND
CART_NOT_ACTIVE
GUEST_EMAIL_MISSING
UNABLE_TO_PLACE_ORDER
UNDEFINED

Example

""CART_NOT_FOUND""

PlaceOrderForPurchaseOrderInput

Specifies the purchase order to convert to an order.

Input Fields

Input Field
Description
purchase_order_uid - ID!
The unique ID of a purchase order.

Example

{"purchase_order_uid": 4}

PlaceOrderForPurchaseOrderOutput

Contains the results of the request to place an order.

Fields

Field Name
Description
order - CustomerOrder!
Placed order.

Example

{"order": CustomerOrder}

PlaceOrderInput

Specifies the quote to be converted to an order.

Input Fields

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

Example

{"cart_id": "xyz789"}

PlaceOrderOutput

Contains the results of the request to place an order.

Fields

Field Name
Description
errors - [PlaceOrderError]!
An array of place order errors.
orderV2 - CustomerOrder
Full order information.

Example

{
  "errors": [PlaceOrderError],
  "orderV2": CustomerOrder
}

PlacePurchaseOrderInput

Specifies the quote to be converted to a purchase order.

Input Fields

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

Example

{"cart_id": "xyz789"}

PlacePurchaseOrderOutput

Contains the results of the request to place a purchase order.

Fields

Field Name
Description
purchase_order - PurchaseOrder!
Placed purchase order.

Example

{"purchase_order": PurchaseOrder}

Price

Defines the price of a simple product or a part of a price range for a complex product. It can include a list of price adjustments.

Fields

Field Name
Description
adjustments - [PriceAdjustment]
The signed value of the price adjustment (positive for markup, negative for markdown).
amount - ProductViewMoney
Contains the monetary value and currency code of a product.

Example

{
  "adjustments": [PriceAdjustment],
  "amount": ProductViewMoney
}

PriceAdjustment

Specifies the amount and type of price adjustment.

Fields

Field Name
Description
amount - Float
The amount of the price adjustment.
code - String
Identifies the type of price adjustment.

Example

{"amount": 987.65, "code": "abc123"}

PriceDetails

Can be used to retrieve the main price details in case of bundle product

Fields

Field Name
Description
discount_percentage - Float
The percentage of discount applied to the main product price
main_final_price - Float
The final price after applying the discount to the main product
main_price - Float
The regular price of the main product

Example

{
  "discount_percentage": 123.45,
  "main_final_price": 123.45,
  "main_price": 123.45
}

PriceRange

Contains the price range for a product. If the product has a single price, the minimum and maximum price will be the same.

Fields

Field Name
Description
maximum_price - ProductPrice
The highest possible price for the product.
minimum_price - ProductPrice!
The lowest possible price for the product.

Example

{
  "maximum_price": ProductPrice,
  "minimum_price": ProductPrice
}

PriceTypeEnum

Defines the price type.

Values

Enum Value
Description
FIXED
PERCENT
DYNAMIC

Example

""FIXED""

PriceViewEnum

Defines whether a bundle product's price is displayed as the lowest possible value or as a range.

Values

Enum Value
Description
PRICE_RANGE
AS_LOW_AS

Example

""PRICE_RANGE""

ProductAlertPriceInput

Input Fields

Input Field
Description
sku - String!

Example

{"sku": "abc123"}

ProductAlertStockInput

Input Fields

Input Field
Description
sku - String!

Example

{"sku": "abc123"}

ProductAlertSubscriptionResult

Fields

Field Name
Description
message - String
success - Boolean!

Example

{"message": "xyz789", "success": false}

ProductAttribute

Contains a product attribute code and value.

Fields

Field Name
Description
code - String!
The unique identifier for a product attribute code.
value - String!
The display value of the attribute.

Example

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

ProductAttributeFile

Fields

Field Name
Description
attribute_type - String
Attribute type code.
code - ID!
The attribute code.
url - String!
Public URL to download the file.
value - String!
Stored filename only (e.g. file_xyz.pdf). Use url for download.

Example

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

ProductCustomAttributes

Product custom attributes

Fields

Field Name
Description
errors - [AttributeMetadataError]!
Errors when retrieving custom attributes metadata.
items - [AttributeValueInterface]!
Requested custom attributes

Example

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

ProductDiscount

Contains the discount applied to a product price.

Fields

Field Name
Description
amount_off - Float
The actual value of the discount.
percent_off - Float
The discount expressed a percentage.

Example

{"amount_off": 123.45, "percent_off": 123.45}

ProductImage

Contains product image information, including the image URL and label.

Fields

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

Example

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

ProductImageThumbnail

Values

Enum Value
Description
ITSELF
Use thumbnail of product as image.
PARENT
Use thumbnail of product's parent as image.

Example

""ITSELF""

ProductInfoInput

Product Information used for Pickup Locations search.

Input Fields

Input Field
Description
sku - String!
Product SKU.

Example

{"sku": "abc123"}

ProductInterface

Contains fields that are common to all types of products.

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

Possible Types

Example

{
  "canonical_url": "abc123",
  "categories": [CategoryInterface],
  "country_of_manufacture": "abc123",
  "crosssell_products": [ProductInterface],
  "custom_attributesV2": ProductCustomAttributes,
  "description": ComplexTextValue,
  "gift_message_available": false,
  "gift_wrapping_available": true,
  "gift_wrapping_price": Money,
  "image": ProductImage,
  "is_returnable": "abc123",
  "manufacturer": 123,
  "max_sale_qty": 123.45,
  "media_gallery": [MediaGalleryInterface],
  "meta_description": "xyz789",
  "meta_keyword": "xyz789",
  "meta_title": "xyz789",
  "min_sale_qty": 987.65,
  "name": "abc123",
  "new_from_date": "abc123",
  "new_to_date": "xyz789",
  "only_x_left_in_stock": 123.45,
  "options_container": "abc123",
  "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"
}

An implementation of ProductLinksInterface.

Fields

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

Example

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

ProductLinksInterface

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

Fields

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

Possible Types

ProductLinksInterface Types
ProductLinks

Example

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

ProductMediaGalleryEntriesAssetImage

Contains basic information about the image asset.

Fields

Field Name
Description
asset_id - String
Asset Id.
media_type - String
Must be asset-image.
media_url - String
Asset Image Url.

Example

{
  "asset_id": "xyz789",
  "media_type": "xyz789",
  "media_url": "xyz789"
}

ProductMediaGalleryEntriesAssetVideo

Contains basic information about the video asset.

Fields

Field Name
Description
media_type - String
Must be asset-video.
video_asset_id - String
Asset Id.
video_media_url - String
Asset Video Url.

Example

{
  "media_type": "xyz789",
  "video_asset_id": "xyz789",
  "video_media_url": "xyz789"
}

ProductMediaGalleryEntriesVideoContent

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

Fields

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

Example

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

ProductPrice

Represents a product price.

Fields

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

Example

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

ProductSearchItem

A single product returned by the query

Fields

Field Name
Description
applied_query_rule - AppliedQueryRule
The query rule type that was applied to this product, if any (in preview mode only, returns null otherwise)
highlights - [Highlight]
An object that provides highlighted text for matched words
productView - ProductView
Contains a product view

Example

{
  "applied_query_rule": AppliedQueryRule,
  "highlights": [Highlight],
  "productView": ProductView
}

ProductSearchResponse

Contains the output of a productSearch query

Fields

Field Name
Description
facets - [Aggregation]
Details about the static and dynamic facets relevant to the search
items - [ProductSearchItem]
An array of products returned by the query
page_info - SearchResultPageInfo
Information for rendering pages of search results
related_terms - [String]
An array of strings that might include merchant-defined synonyms
suggestions - [String]
An array of strings that include the names of products and categories that exist in the catalog that are similar to the search query
total_count - Int
The total number of products returned that matched the query
warnings - [ProductSearchWarning]
An array of warning messages for validation issues (e.g., sort parameter ignored due to missing categoryPath)

Example

{
  "facets": [Aggregation],
  "items": [ProductSearchItem],
  "page_info": SearchResultPageInfo,
  "related_terms": ["abc123"],
  "suggestions": ["abc123"],
  "total_count": 123,
  "warnings": [ProductSearchWarning]
}

ProductSearchSortInput

The product attribute to sort on

Input Fields

Input Field
Description
attribute - String!
The attribute code of a product attribute
direction - SortEnum!
ASC (ascending) or DESC (descending)

Example

{"attribute": "abc123", "direction": "ASC"}

ProductSearchWarning

Structured warning with code and message for easier client handling

Fields

Field Name
Description
code - String!
Error code for programmatic handling (e.g., EMPTY_CATEGORY_PATH)
message - String!
Human-readable message describing the warning

Example

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

ProductStockStatus

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

Values

Enum Value
Description
IN_STOCK
OUT_OF_STOCK

Example

""IN_STOCK""

ProductVideo

Contains information about a product video.

Fields

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

Example

{
  "disabled": true,
  "label": "abc123",
  "position": 123,
  "url": "abc123",
  "video_content": ProductMediaGalleryEntriesVideoContent
}

ProductView

Defines the product fields available to the SimpleProductView and ComplexProductView types.

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.
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 title for search results listings.
shortDescription - String
A summary of the product for search results listings.
inputOptions - [ProductViewInputOption]
A list of input options. For example, a text field, a number field or a date field. (Deprecated: This field is deprecated and will be removed.)
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. This is a unique identifier for the product that is used to create the product's URL.
links - [ProductViewLink]
A list of product links. For example, related, up-sell, and cross-sell links.
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

Possible Types

Example

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

ProductViewAttribute

A container for customer-defined attributes that are displayed the storefront.

Fields

Field Name
Description
label - String
Label of the attribute.
name - String!
Name of an attribute code. For example, `color`, `size` or `material`
roles - [String]
Roles designated for an attribute on the storefront. For example, `show_on_plp`, `show_in_pdp` or `show_in_search`
value - JSON
Attribute value, arbitrary of type. For example, `red`, `blue` or `green`

Example

{
  "label": "abc123",
  "name": "abc123",
  "roles": ["abc123"],
  "value": {}
}

ProductViewCurrency

The list of supported currency codes.

Values

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

Example

""AED""

ProductViewImage

Contains details about a product image.

Fields

Field Name
Description
label - String
The display label of the product image. For example, `Main Image`, `Small Image` or `Thumbnail Image`
roles - [String]
A list that describes how the image is used. Can be `image`, `small_image` or `thumbnail`
url - String!
The URL to the product image. For example, `https://example.com/image.jpg`.

Example

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

ProductViewInputOption

Product options provide a way to configure products by making selections of particular option values. Selecting one or many options will point to a simple product.

Fields

Field Name
Description
id - ID
The ID of an option value. For example, `123` for the first option value, `456` for the second option value.
title - String
The display name of the option value. For example, `Red`, `Blue` or `Green`
required - Boolean
Indicates whether this input option is required.
type - String
The type of data entry. For example, `text`, `number` or `date`
markupAmount - Float
The percentage the prices is marked up or down. A positive value, such as `10.00`, indicates the product is marked up 10%. A negative value, such as `-10.00`, indicates the price is marked down 10%.
suffix - String
SKU suffix to add to the product. For example, `-red`, `-blue` or `-green`
sortOrder - Int
Sort order for the input option. For example, `1` for the first input option, `2` for the second input option.
range - ProductViewInputOptionRange
The range of values for the input option. For example, if the input option is a text field, the range represents the number of characters.
imageSize - ProductViewInputOptionImageSize
The size of the image for the input option.
fileExtensions - String
The file extensions allowed for the image. For example, `jpg`, `png`, `gif`, or `svg`

Example

{
  "id": 4,
  "title": "abc123",
  "required": false,
  "type": "abc123",
  "markupAmount": 987.65,
  "suffix": "xyz789",
  "sortOrder": 987,
  "range": ProductViewInputOptionRange,
  "imageSize": ProductViewInputOptionImageSize,
  "fileExtensions": "abc123"
}

ProductViewInputOptionImageSize

Dimensions of the image associated with the input option.

Fields

Field Name
Description
width - Int
The width of the image in pixels. For example, `100` for a 100px width.
height - Int
The height of the image, in pixels. For example, `100` for a 100px height.

Example

{"width": 123, "height": 123}

ProductViewInputOptionRange

Lists the value range associated with a ProductViewInputOption. For example, if the input option is a text field, the range represents the number of characters.

Fields

Field Name
Description
from - Float
The starting value of the range. For example, if the input option is a text field, the starting value represents the minimum number of characters.
to - Float
The ending value of the range. For example, if the input option is a text field, the ending value represents the maximum number of characters.

Example

{"from": 987.65, "to": 987.65}

The product link type. Contains details about product links for related products and cross selling. For example, related, up_sell or cross_sell

Fields

Field Name
Description
product - ProductView!
Contains the details of the product found in the link.
linkTypes - [String!]!
Stores the types of the links with this product.

Example

{
  "product": ProductView,
  "linkTypes": ["xyz789"]
}

ProductViewMoney

Defines a monetary value, including a numeric value and a currency code.

Fields

Field Name
Description
currency - ProductViewCurrency
A three-letter currency code, such as USD or EUR.
value - Float
A number expressing a monetary value.

Example

{"currency": "AED", "value": 987.65}

ProductViewOption

Product options provide a way to configure products by making selections of particular option values. Selecting one or many options will point to a simple product.

Fields

Field Name
Description
id - ID
The ID of the option. For example, `123` for the first option, `456` for the second option.
multi - Boolean
Indicates whether the option allows multiple choices. The value is `true` for a multi-select option, `false` for a single-select option.
required - Boolean
Indicates whether the option must be selected.
title - String
The display name of the option. For example, `Color`, `Size` or `Material`
values - [ProductViewOptionValue!]
List of available option values. For example, `Red`, `Blue` or `Green`

Example

{
  "id": "4",
  "multi": true,
  "required": false,
  "title": "xyz789",
  "values": [ProductViewOptionValue]
}

ProductViewOptionValue

Defines the product fields available to the ProductViewOptionValueProduct and ProductViewOptionValueConfiguration types.

Fields

Field Name
Description
id - ID
The ID of an option value.
title - String
The display name of the option value.
inStock - Boolean
Indicates whether the remaining quantity of the product has reached the out-of-stock threshold.

Possible Types

Example

{
  "id": "4",
  "title": "xyz789",
  "inStock": false
}

ProductViewOptionValueConfiguration

An implementation of ProductViewOptionValue for configuration values.

Fields

Field Name
Description
id - ID
The ID of an option value. For example, `123` for the first option value, `456` for the second option value.
title - String
The display name of the option value. For example, `Red`, `Blue` or `Green`
inStock - Boolean
Indicates whether the remaining quantity of the product option value has reached the out-of-stock threshold.

Example

{
  "id": "4",
  "title": "xyz789",
  "inStock": false
}

ProductViewOptionValueProduct

An implementation of ProductViewOptionValue that adds details about a simple product.

Fields

Field Name
Description
id - ID
The ID of an option value. For example, `123` for the first option value, `456` for the second option value.
isDefault - Boolean
Indicates whether the option value is the default.
product - SimpleProductView
Details about a simple product. For example, a product with a SKU of `123`, a name of `Product 1`, a price of `100.00`.
quantity - Float
Default quantity of an option value.
title - String
The display name of the option value. For example, `Red`, `Blue` or `Green`
inStock - Boolean
Indicates whether the remaining quantity of the product option value has reached the out-of-stock threshold.

Example

{
  "id": 4,
  "isDefault": true,
  "product": SimpleProductView,
  "quantity": 123.45,
  "title": "xyz789",
  "inStock": true
}

ProductViewOptionValueSwatch

An implementation of ProductViewOptionValueSwatch for swatches.

Fields

Field Name
Description
id - ID
The ID of an option value. For example, `123` for the first option value, `456` for the second option value.
title - String
The display name of the option value. For example, `Red`, `Blue` or `Green`
type - SwatchType
Indicates the type of the swatch.
value - String
The value of the swatch depending on the type of the swatch.
inStock - Boolean
Indicates whether the remaining quantity of the product option value has reached the out-of-stock threshold.

Example

{
  "id": "4",
  "title": "xyz789",
  "type": "TEXT",
  "value": "abc123",
  "inStock": true
}

ProductViewPrice

Base product price view. Contains the final price after discounts, the regular price, and the list of tier prices.

Fields

Field Name
Description
final - Price
Price value after discounts, excluding personalized promotions.
regular - Price
Base product price specified by the merchant.
tiers - [ProductViewTierPrice]
Volume based pricing.
roles - [String]
Price roles, stating if the price should be visible or hidden. For example, `show_on_plp`, `show_in_pdp` or `show_in_search`

Example

{
  "final": Price,
  "regular": Price,
  "tiers": [ProductViewTierPrice],
  "roles": ["xyz789"]
}

ProductViewPriceRange

The minimum and maximum price of a complex product.

Fields

Field Name
Description
maximum - ProductViewPrice
Maximum price.
minimum - ProductViewPrice
Minimum price.

Example

{
  "maximum": ProductViewPrice,
  "minimum": ProductViewPrice
}

ProductViewTierCondition

Types

Example

ProductViewTierRangeCondition

ProductViewTierExactMatchCondition

Minimum quantity (inclusive) required to activate this tier price. For example, a value of 10 means this tier applies when 10 or more items are purchased.

Fields

Field Name
Description
in - [Float]
Exact quantity values that activate this tier price. For example, `[5, 10]` means the tier applies only when the purchased quantity is exactly 5 or exactly 10.

Example

{"in": [987.65]}

ProductViewTierPrice

The discounted price that applies when the quantity conditions in quantity are satisfied. Contains the monetary amount and any price adjustments applied to this tier.

Fields

Field Name
Description
tier - Price
The discounted price that applies when the quantity conditions in `quantity` are satisfied. Contains the monetary amount and any price adjustments applied to this tier.
quantity - [ProductViewTierCondition!]!
The quantity conditions that must be met to activate the tier price. For example, `10` for a quantity of 10 or `20` for a quantity of 20.

Example

{
  "tier": Price,
  "quantity": [ProductViewTierRangeCondition]
}

ProductViewTierRangeCondition

Minimum quantity (inclusive) required to activate this tier price. For example, a value of 10 means this tier applies when 10 or more items are purchased. Maximum quantity (exclusive) required to activate this tier price. For example, a value of 20 means this tier applies when less than 20 items are purchased.

Fields

Field Name
Description
gte - Float
The minimum quantity that must be purchased to activate the tier price. Must be greater than or equal to the value in `gte`.
lt - Float
Maximum quantity (exclusive) for this tier price. For example, a value of `20` means this tier applies only when fewer than 20 items are purchased.

Example

{"gte": 123.45, "lt": 987.65}

ProductViewVariant

Represents a product variant.

Fields

Field Name
Description
selections - [String!]
List of option values that make up the variant. For example, `red`, `blue` or `green`
product - ProductView
Product corresponding to the variant. For example, a product with a SKU of `123`, a name of `Product 1`, a price of `100.00`.

Example

{
  "selections": ["xyz789"],
  "product": ProductView
}

ProductViewVariantResults

Represents the results of a product variant search.

Fields

Field Name
Description
variants - [ProductViewVariant]!
List of product variants. For example, a variant with a selection of `red`, `blue` or `green`
cursor - String
Pagination cursor. For example, `123` for the first variant, `456` for the second variant.

Example

{
  "variants": [ProductViewVariant],
  "cursor": "abc123"
}

ProductViewVideo

Contains details about a product video. For example, a video of the product being used or a video of the product being assembled.

Fields

Field Name
Description
preview - ProductViewImage
Preview image for the video. For example, a screenshot of the video.
url - String!
The URL to the product video. For example, `https://example.com/video.mp4` or `https://example.com/video.webm`
description - String
Description of the product video. For example, `A video of the product being used` or `A video of the product being assembled`
title - String
The title of the product video. For example, `Product Video` or `Product Assembly Video`

Example

{
  "preview": ProductViewImage,
  "url": "xyz789",
  "description": "xyz789",
  "title": "abc123"
}

PurchaseHistory

User purchase history

Input Fields

Input Field
Description
date - DateTime
items - [String]!

Example

{
  "date": "2007-12-03T10:15:30Z",
  "items": ["xyz789"]
}

PurchaseOrder

Contains details about a purchase order.

Fields

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

Example

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

PurchaseOrderAction

Values

Enum Value
Description
REJECT
CANCEL
VALIDATE
APPROVE
PLACE_ORDER

Example

""REJECT""

PurchaseOrderActionError

Contains details about a failed action.

Fields

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

Example

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

PurchaseOrderApprovalFlowEvent

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

Fields

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

Example

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

PurchaseOrderApprovalFlowItemStatus

Values

Enum Value
Description
PENDING
APPROVED
REJECTED

Example

""PENDING""

PurchaseOrderApprovalRule

Contains details about a purchase order approval rule.

Fields

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

Example

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

PurchaseOrderApprovalRuleConditionAmount

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

Fields

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

Example

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

PurchaseOrderApprovalRuleConditionInterface

Purchase order rule condition details.

Fields

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

Possible Types

Example

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

PurchaseOrderApprovalRuleConditionOperator

Values

Enum Value
Description
MORE_THAN
LESS_THAN
MORE_THAN_OR_EQUAL_TO
LESS_THAN_OR_EQUAL_TO

Example

""MORE_THAN""

PurchaseOrderApprovalRuleConditionQuantity

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

Fields

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

Example

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

PurchaseOrderApprovalRuleInput

Defines a new purchase order approval rule.

Input Fields

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

Example

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

PurchaseOrderApprovalRuleMetadata

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

Fields

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

Example

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

PurchaseOrderApprovalRuleStatus

Values

Enum Value
Description
ENABLED
DISABLED

Example

""ENABLED""

PurchaseOrderApprovalRuleType

Values

Enum Value
Description
GRAND_TOTAL
SHIPPING_INCL_TAX
NUMBER_OF_SKUS

Example

""GRAND_TOTAL""

PurchaseOrderApprovalRules

Contains the approval rules that the customer can see.

Fields

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

Example

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

PurchaseOrderComment

Contains details about a comment.

Fields

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

Example

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

PurchaseOrderErrorType

Values

Enum Value
Description
NOT_FOUND
OPERATION_NOT_APPLICABLE
COULD_NOT_SAVE
NOT_VALID_DATA
UNDEFINED

Example

""NOT_FOUND""

PurchaseOrderHistoryItem

Contains details about a status change.

Fields

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

Example

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

PurchaseOrderRuleApprovalFlow

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

Fields

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

Example

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

PurchaseOrderStatus

Values

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

Example

""PENDING""

PurchaseOrders

Contains a list of purchase orders.

Fields

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

Example

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

PurchaseOrdersActionInput

Defines which purchase orders to act on.

Input Fields

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

Example

{"purchase_order_uids": ["4"]}

PurchaseOrdersActionOutput

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

Fields

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

Example

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

PurchaseOrdersFilterInput

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

Input Fields

Input Field
Description
company_purchase_orders - Boolean
Include only purchase orders made by subordinate company users.
created_date - FilterRangeTypeInput
Filter by the creation date of the purchase order.
my_approvals - Boolean
Include purchase orders that are pending approval by the customer or eligible for their approval but have already been dealt with.
require_my_approval - Boolean
Include only purchase orders that are waiting for the customer’s approval.
status - PurchaseOrderStatus
Filter by the status of the purchase order.

Example

{
  "company_purchase_orders": false,
  "created_date": FilterRangeTypeInput,
  "my_approvals": false,
  "require_my_approval": false,
  "status": "PENDING"
}

QueryContextInput

Input Fields

Input Field
Description
customerGroup - String!
The customer group code. Field reserved for future use. Currently, passing this field will have no impact on search results, that is, the search results will be for "Not logged in" customer
userViewHistory - [ViewHistoryInput!]
User view history with timestamp

Example

{
  "customerGroup": "abc123",
  "userViewHistory": [ViewHistoryInput]
}

QuoteItemsSortInput

Specifies the field to use for sorting quote items

Input Fields

Input Field
Description
field - SortQuoteItemsEnum!
Specifies the quote items field to sort by
order - SortEnum!
Specifies the order of quote items' sorting

Example

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

QuoteTemplateExpirationDateInput

Sets quote template expiration date.

Input Fields

Input Field
Description
expiration_date - String!
The expiration period of the negotiable quote template.
template_id - ID!
The unique ID of a `NegotiableQuoteTemplate` object.

Example

{
  "expiration_date": "abc123",
  "template_id": "4"
}

QuoteTemplateLineItemNoteInput

Sets quote item note.

Input Fields

Input Field
Description
item_id - ID
The unique ID of a `CartLineItem` object.
item_uid - ID
The unique ID of a `CartLineItem` object.
note - String
The note text to be added.
templateId - ID!
The unique ID of a `NegotiableQuoteTemplate` object.

Example

{
  "item_id": "4",
  "item_uid": 4,
  "note": "abc123",
  "templateId": "4"
}

QuoteTemplateNotificationMessage

Contains a notification message for a negotiable quote template.

Fields

Field Name
Description
message - String!
The notification message.
type - String!
The type of notification message.

Example

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

RangeBucket

For use on numeric product fields

Fields

Field Name
Description
count - Int!
The number of items in the bucket
from - Float!
The minimum amount in a price range
title - String!
The display text defining the price range
to - Float
The maximum amount in a price range

Example

{
  "count": 987,
  "from": 123.45,
  "title": "xyz789",
  "to": 123.45
}

RangeOperatorInput

Input Fields

Input Field
Description
type - RangeType
value - RangeValueInput

Example

{"type": "UNKNOWN_RANGE_TYPE", "value": RangeValueInput}

RangeType

Values

Enum Value
Description
UNKNOWN_RANGE_TYPE
STATIC
PERCENTAGE
DYNAMIC

Example

""UNKNOWN_RANGE_TYPE""

RangeValueInput

Input Fields

Input Field
Description
from - Float
to - Float

Example

{"from": 987.65, "to": 987.65}

ReCaptchaConfigOutput

Fields

Field Name
Description
configurations - ReCaptchaConfiguration
Configuration details for reCaptcha type
is_enabled - Boolean!
Indicates whether reCaptcha type is enabled

Example

{
  "configurations": ReCaptchaConfiguration,
  "is_enabled": false
}

ReCaptchaConfiguration

Contains reCAPTCHA form configuration details.

Fields

Field Name
Description
badge_position - String
The position of the invisible reCAPTCHA badge on each page.
language_code - String
A two-character code that specifies the language that is used for Google reCAPTCHA text and messaging.
minimum_score - Float
The minimum score that identifies a user interaction as a potential risk.
re_captcha_type - ReCaptchaTypeEmum!
technical_failure_message - String!
The message that appears when reCaptcha fails.
theme - String!
Theme to be used to render reCaptcha.
validation_failure_message - String!
The message that appears to the user if validation fails.
website_key - String!
The website key generated when the Google reCAPTCHA account was registered.

Example

{
  "badge_position": "xyz789",
  "language_code": "abc123",
  "minimum_score": 123.45,
  "re_captcha_type": "INVISIBLE",
  "technical_failure_message": "xyz789",
  "theme": "abc123",
  "validation_failure_message": "abc123",
  "website_key": "xyz789"
}

ReCaptchaConfigurationV3

Contains reCAPTCHA V3-Invisible configuration details.

Fields

Field Name
Description
badge_position - String!
The position of the invisible reCAPTCHA badge on each page.
failure_message - String!
The message that appears to the user if validation fails.
forms - [ReCaptchaFormEnum]!
A list of forms on the storefront that have been configured to use reCAPTCHA V3.
is_enabled - Boolean!
Return whether recaptcha is enabled or not
language_code - String
A two-character code that specifies the language that is used for Google reCAPTCHA text and messaging.
minimum_score - Float!
The minimum score that identifies a user interaction as a potential risk.
theme - String!
Theme to be used to render reCaptcha.
website_key - String!
The website key generated when the Google reCAPTCHA account was registered.

Example

{
  "badge_position": "abc123",
  "failure_message": "xyz789",
  "forms": ["PLACE_ORDER"],
  "is_enabled": false,
  "language_code": "xyz789",
  "minimum_score": 123.45,
  "theme": "abc123",
  "website_key": "xyz789"
}

ReCaptchaFormConfigItem

Contains reCAPTCHA configuration for a specific form type.

Fields

Field Name
Description
configurations - ReCaptchaConfiguration
Configuration details for reCaptcha type.
form_type - ReCaptchaFormEnum!
The form type identifier.
is_enabled - Boolean!
Indicates whether reCaptcha is enabled for this form type.

Example

{
  "configurations": ReCaptchaConfiguration,
  "form_type": "PLACE_ORDER",
  "is_enabled": false
}

ReCaptchaFormEnum

Values

Enum Value
Description
PLACE_ORDER
CONTACT
CUSTOMER_LOGIN
CUSTOMER_FORGOT_PASSWORD
CUSTOMER_CREATE
CUSTOMER_EDIT
NEWSLETTER
PRODUCT_REVIEW
SENDFRIEND
BRAINTREE
RESEND_CONFIRMATION_EMAIL

Example

""PLACE_ORDER""

ReCaptchaTypeEmum

Values

Enum Value
Description
INVISIBLE
RECAPTCHA
RECAPTCHA_V3
RECAPTCHA_ENTERPRISE

Example

""INVISIBLE""

RecommendationUnit

Recommendation Unit containing product and other details

Fields

Field Name
Description
displayOrder - Int
Order in which recommendation units are displayed
pageType - String
Page type
productsView - [ProductView]
List of product view
storefrontLabel - String
Storefront label to be displayed on the storefront
totalProducts - Int
Total products returned in recommedations
typeId - String
Type of recommendation
unitId - String
Id of the preconfigured unit
unitName - String
Name of the preconfigured unit

Example

{
  "displayOrder": 987,
  "pageType": "xyz789",
  "productsView": [ProductView],
  "storefrontLabel": "abc123",
  "totalProducts": 987,
  "typeId": "abc123",
  "unitId": "xyz789",
  "unitName": "xyz789"
}

Recommendations

Recommendations response

Fields

Field Name
Description
results - [RecommendationUnit]
List of rec units with products recommended
totalResults - Int
total number of rec units for which recommendations are returned

Example

{"results": [RecommendationUnit], "totalResults": 123}

Region

Fields

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

Example

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

RemoveCouponFromCartInput

Specifies the cart from which to remove a coupon.

Input Fields

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

Example

{"cart_id": "xyz789"}

RemoveCouponFromCartOutput

Contains details about the cart after removing a coupon.

Fields

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

Example

{"cart": Cart}

RemoveCouponsFromCartInput

Remove coupons from the cart.

Input Fields

Input Field
Description
cart_id - String!
The unique ID of a `Cart` object.
coupon_codes - [String]!
An array of coupon codes to be removed from the quote. If coupon_codes is empty all coupons will be removed from the quote.

Example

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

RemoveGiftCardFromCartInput

Defines the input required to run the removeGiftCardFromCart mutation.

Input Fields

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

Example

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

RemoveGiftCardFromCartOutput

Defines the possible output for the removeGiftCardFromCart mutation.

Fields

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

Example

{"cart": Cart}

RemoveGiftRegistryItemsOutput

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

Fields

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

Example

{"gift_registry": GiftRegistry}

RemoveGiftRegistryOutput

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

Fields

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

Example

{"success": true}

RemoveGiftRegistryRegistrantsOutput

Contains the results of a request to delete a registrant.

Fields

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

Example

{"gift_registry": GiftRegistry}

RemoveItemFromCartInput

Specifies which items to remove from the cart.

Input Fields

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

Example

{"cart_id": "abc123", "cart_item_uid": 4}

RemoveItemFromCartOutput

Contains details about the cart after removing an item.

Fields

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

Example

{"cart": Cart}

RemoveNegotiableQuoteItemsInput

Defines the items to remove from the specified negotiable quote.

Input Fields

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

Example

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

RemoveNegotiableQuoteItemsOutput

Contains the negotiable quote.

Fields

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

Example

{"quote": NegotiableQuote}

RemoveNegotiableQuoteTemplateItemsInput

Defines the items to remove from the specified negotiable quote.

Input Fields

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

Example

{"item_uids": [4], "template_id": 4}

RemoveProductsFromCompareListInput

Defines which products to remove from a compare list.

Input Fields

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

Example

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

RemoveProductsFromWishlistOutput

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

Fields

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

Example

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

RemoveReturnTrackingInput

Defines the tracking information to delete.

Input Fields

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

Example

{"return_shipping_tracking_uid": "4"}

RemoveReturnTrackingOutput

Contains the response after deleting tracking information.

Fields

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

Example

{"return": Return}

RemoveRewardPointsFromCartOutput

Contains the customer cart.

Fields

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

Example

{"cart": Cart}

RemoveStoreCreditFromCartInput

Defines the input required to run the removeStoreCreditFromCart mutation.

Input Fields

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

Example

{"cart_id": "xyz789"}

RemoveStoreCreditFromCartOutput

Defines the possible output for the removeStoreCreditFromCart mutation.

Fields

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

Example

{"cart": Cart}

RenameNegotiableQuoteInput

Sets new name for a negotiable quote.

Input Fields

Input Field
Description
quote_comment - String
The reason for the quote name change specified by the buyer.
quote_name - String!
The new quote name the buyer specified to the negotiable quote request.
quote_uid - ID!
The cart ID of the buyer requesting a new negotiable quote.

Example

{
  "quote_comment": "abc123",
  "quote_name": "abc123",
  "quote_uid": "4"
}

RenameNegotiableQuoteOutput

Contains the updated negotiable quote.

Fields

Field Name
Description
quote - NegotiableQuote
The negotiable quote after updating the name.

Example

{"quote": NegotiableQuote}

ReorderItemsOutput

Contains the cart and any errors after adding products.

Fields

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

Example

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

RequestGuestReturnInput

Contains information needed to start a return request.

Input Fields

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

Example

{
  "comment_text": "xyz789",
  "contact_email": "xyz789",
  "items": [RequestReturnItemInput],
  "token": "abc123"
}

RequestNegotiableQuoteInput

Defines properties of a negotiable quote request.

Input Fields

Input Field
Description
cart_id - ID!
The cart ID of the buyer requesting a new negotiable quote.
comment - NegotiableQuoteCommentInput!
Comments the buyer entered to describe the request.
is_draft - Boolean
Flag indicating if quote is draft or not.
quote_name - String!
The name the buyer assigned to the negotiable quote request.

Example

{
  "cart_id": "4",
  "comment": NegotiableQuoteCommentInput,
  "is_draft": false,
  "quote_name": "xyz789"
}

RequestNegotiableQuoteOutput

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

Fields

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

Example

{"quote": NegotiableQuote}

RequestNegotiableQuoteTemplateInput

Defines properties of a negotiable quote template request.

Input Fields

Input Field
Description
cart_id - ID!
The cart ID of the quote to create the new negotiable quote template from.

Example

{"cart_id": 4}

RequestReturnInput

Contains information needed to start a return request.

Input Fields

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

Example

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

RequestReturnItemInput

Contains details about an item to be returned.

Input Fields

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

Example

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

RequestReturnOutput

Contains the response to a return request.

Fields

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

Example

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

RequisitionList

Defines the contents of a requisition list.

Fields

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

Example

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

RequisitionListFilterInput

Defines requisition list filters.

Input Fields

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

Example

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

RequisitionListItemInterface

The interface for requisition list items.

Fields

Field Name
Description
customizable_options - [SelectedCustomizableOption]!
Selected custom options for an item in the requisition list.
product - ProductInterface!
Details about a requisition list item. (Deprecated: Product information is part of a composable Catalog Service.)
quantity - Float!
The amount added.
sku - String!
The product SKU.
uid - ID!
The unique ID for the requisition list item.

Possible Types

Example

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

RequisitionListItemsInput

Defines the items to add.

Input Fields

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

Example

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

RequisitionListSortInput

Defines the field to use to sort a list of requisition lists.

Input Fields

Input Field
Description
sort_direction - SortEnum
Whether to return results in ascending or descending order.
sort_field - RequisitionListSortableField!
The specified sort field.

Example

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

RequisitionListSortableField

Values

Enum Value
Description
NAME
Sorts requisition lists by requisition list name.
UPDATED_AT
Sorts requisition lists by the date they were last updated.

Example

""NAME""

RequisitionLists

Defines customer requisition lists.

Fields

Field Name
Description
items - [RequisitionList]
An array of requisition lists.
page_info - SearchResultPageInfo
Pagination metadata.
sort_fields - SortFields
Contains the default sort field and all available sort fields.
total_count - Int
The number of returned requisition lists.

Example

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

RequistionListItems

Contains an array of items added to a requisition list.

Fields

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

Example

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

Return

Contains details about a return.

Fields

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

Example

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

ReturnComment

Contains details about a return comment.

Fields

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

Example

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

ReturnCustomer

The customer information for the return.

Fields

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

Example

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

ReturnItem

Contains details about a product being returned.

Fields

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

Example

{
  "custom_attributesV2": [AttributeValueInterface],
  "order_item": OrderItemInterface,
  "quantity": 987.65,
  "request_quantity": 987.65,
  "status": "PENDING",
  "uid": "4"
}

ReturnItemAttributeMetadata

Return Item attribute metadata.

Fields

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

Example

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

ReturnItemStatus

Values

Enum Value
Description
PENDING
AUTHORIZED
RECEIVED
APPROVED
REJECTED
DENIED

Example

""PENDING""

ReturnShipping

Contains details about the return shipping address.

Fields

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

Example

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

ReturnShippingAddress

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

Fields

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

Example

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

ReturnShippingCarrier

Contains details about the carrier on a return.

Fields

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

Example

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

ReturnShippingTracking

Contains shipping and tracking details.

Fields

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

Example

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

ReturnShippingTrackingStatus

Contains the status of a shipment.

Fields

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

Example

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

ReturnShippingTrackingStatusType

Values

Enum Value
Description
INFORMATION
ERROR

Example

""INFORMATION""

ReturnStatus

Values

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

Example

""PENDING""

Returns

Contains a list of customer return requests.

Fields

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

Example

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

RevokeCustomerTokenOutput

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

Fields

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

Example

{"result": true}

RewardPoints

Contains details about a customer's reward points.

Fields

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

Example

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

RewardPointsAmount

Fields

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

Example

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

RewardPointsBalanceHistoryItem

Contain details about the reward points transaction.

Fields

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

Example

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

RewardPointsExchangeRates

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

Fields

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

Example

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

RewardPointsRate

Contains details about customer's reward points rate.

Fields

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

Example

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

RewardPointsSubscriptionStatus

Indicates whether the customer subscribes to reward points emails.

Fields

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

Example

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

RewardPointsSubscriptionStatusesEnum

Values

Enum Value
Description
SUBSCRIBED
NOT_SUBSCRIBED

Example

""SUBSCRIBED""

SDKParams

Defines the name and value of a SDK parameter

Fields

Field Name
Description
name - String
The name of the SDK parameter
value - String
The value of the SDK parameter

Example

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

SalesCommentItem

Contains details about a comment.

Fields

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

Example

{
  "message": "xyz789",
  "timestamp": "xyz789"
}

ScalarBucket

For use on string and other scalar product fields

Fields

Field Name
Description
count - Int!
The number of items in the bucket
id - ID!
An identifier that can be used for filtering. It may contain non-human readable data
title - String!
The display text for the scalar value

Example

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

ScopeTypeEnum

This enumeration defines the scope type for customer orders.

Values

Enum Value
Description
GLOBAL
WEBSITE
STORE

Example

""GLOBAL""

SearchCategoryResultPage

Represents a paginated result set of category search results.

Fields

Field Name
Description
items - [CategoryTreeView!]!
The list of categories matching the search criteria.
totalCount - Int!
The total number of categories matching the search criteria across all pages.
pageInfo - PageInfo!
Pagination information for navigating through results.

Example

{
  "items": [CategoryTreeView],
  "totalCount": 987,
  "pageInfo": PageInfo
}

SearchClauseInput

A product attribute to filter on

Input Fields

Input Field
Description
attribute - String!
The attribute code of a product attribute
contains - String
attribute value should contain the specified string
eq - String
A string value to filter on
in - [String]
An array of string values to filter on
range - SearchRangeInput
A range of numeric values to filter on
startsWith - String
attribute value should start with the specified string

Example

{
  "attribute": "xyz789",
  "contains": "xyz789",
  "eq": "abc123",
  "in": ["xyz789"],
  "range": SearchRangeInput,
  "startsWith": "abc123"
}

SearchRangeInput

A range of numeric values for use in a search

Input Fields

Input Field
Description
from - Float
The minimum value to filter on. If not specified, the value of `0` is applied
to - Float
The maximum value to filter on

Example

{"from": 123.45, "to": 123.45}

SearchResultPageInfo

Provides navigation for the query response.

Fields

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

Example

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

SelectedBundleOption

Contains details about a selected bundle option.

Fields

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

Example

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

SelectedBundleOptionValue

Contains details about a value for a selected bundle option.

Fields

Field Name
Description
label - String!
The display name of the value for the selected bundle product option.
original_price - Money!
The original price of the value for the selected bundle product option.
priceV2 - Money!
The price of the value for the selected bundle product option.
quantity - Float!
The quantity of the value for the selected bundle product option.
uid - ID!
The unique ID for a `SelectedBundleOptionValue` object

Example

{
  "label": "xyz789",
  "original_price": Money,
  "priceV2": Money,
  "quantity": 123.45,
  "uid": 4
}

SelectedConfigurableOption

Contains details about a selected configurable option.

Fields

Field Name
Description
configurable_product_option_uid - ID!
The unique ID for a `ConfigurableProductOptions` object.
configurable_product_option_value_uid - ID!
The unique ID for a `ConfigurableProductOptionsValues` object.
option_label - String!
The display text for the option.
value_label - String!
The display name of the selected configurable option.

Example

{
  "configurable_product_option_uid": "4",
  "configurable_product_option_value_uid": 4,
  "option_label": "abc123",
  "value_label": "abc123"
}

SelectedCustomAttributeInput

Contains details about an attribute the buyer selected.

Input Fields

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

Example

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

SelectedCustomizableOption

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

Fields

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

Example

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

SelectedCustomizableOptionValue

Identifies the value of the selected customized option.

Fields

Field Name
Description
customizable_option_value_uid - ID!
The unique ID for a value object that corresponds to the object represented by the `customizable_option_uid` attribute.
label - String!
The display name of the selected value.
price - CartItemSelectedOptionValuePrice!
The price of the selected customizable value.
value - String!
The text identifying the selected value.

Example

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

SelectedPaymentMethod

Describes the payment method selected by the shopper.

Fields

Field Name
Description
code - String!
The payment method code.
oope_payment_method_config - OopePaymentMethodConfig
Configuration for out of process payment methods
purchase_order_number - String
The purchase order number.
title - String!
The payment method title.

Example

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

SelectedShippingMethod

Contains details about the selected shipping method and carrier.

Fields

Field Name
Description
additional_data - [ShippingAdditionalData]
Additional data related to the shipping method.
amount - Money!
The cost of shipping using this shipping method.
carrier_code - String!
A string that identifies a commercial carrier or an offline shipping method.
carrier_title - String!
The label for the carrier code.
method_code - String!
A shipping method code associated with a carrier.
method_title - String!
The label for the method code.
price_excl_tax - Money!
The cost of shipping using this shipping method, excluding tax.
price_incl_tax - Money!
The cost of shipping using this shipping method, including tax.

Example

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

SendNegotiableQuoteForReviewInput

Specifies which negotiable quote to send for review.

Input Fields

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

Example

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

SendNegotiableQuoteForReviewOutput

Contains the negotiable quote.

Fields

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

Example

{"quote": NegotiableQuote}

SetBillingAddressOnCartInput

Sets the billing address.

Input Fields

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

Example

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

SetBillingAddressOnCartOutput

Contains details about the cart after setting the billing address.

Fields

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

Example

{"cart": Cart}

SetCartAsInactiveOutput

Sets the cart as inactive

Fields

Field Name
Description
error - String
The error message returned after failing to set the cart as inactive
success - Boolean!
Indicates whether the cart was set as inactive

Example

{"error": "abc123", "success": true}

SetCustomAttributesOnCompanyInput

Defines the company custom attributes.

Input Fields

Input Field
Description
custom_attributes - [CustomAttributeInput]
An array of custom attributes for company.
id - ID!
The unique ID of a `company` object.

Example

{
  "custom_attributes": [CustomAttributeInput],
  "id": "4"
}

SetCustomAttributesOnCompanyOutput

Contains the company.

Fields

Field Name
Description
company - Company
The company after assigning custom attributes.

Example

{"company": Company}

SetCustomAttributesOnNegotiableQuoteInput

Defines the negotiable quote custom attributes.

Input Fields

Input Field
Description
custom_attributes - [CustomAttributeInput]
An array of custom attributes for NegotiableQuote.
quote_uid - ID!
The unique ID of a `NegotiableQuote` object.

Example

{
  "custom_attributes": [CustomAttributeInput],
  "quote_uid": "4"
}

SetCustomAttributesOnNegotiableQuoteOutput

Contains the negotiable quote.

Fields

Field Name
Description
quote - NegotiableQuote
The negotiable quote after assigning custom attributes.

Example

{"quote": NegotiableQuote}

SetGiftOptionsOnCartInput

Defines the gift options applied to the cart.

Input Fields

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

Example

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

SetGiftOptionsOnCartOutput

Contains the cart after gift options have been applied.

Fields

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

Example

{"cart": Cart}

SetGuestEmailOnCartInput

Defines the guest email and cart.

Input Fields

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

Example

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

SetGuestEmailOnCartOutput

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

Fields

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

Example

{"cart": Cart}

SetLineItemNoteOutput

Contains the updated negotiable quote.

Fields

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

Example

{"quote": NegotiableQuote}

SetNegotiableQuoteBillingAddressInput

Sets the billing address.

Input Fields

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

Example

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

SetNegotiableQuoteBillingAddressOutput

Contains the negotiable quote.

Fields

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

Example

{"quote": NegotiableQuote}

SetNegotiableQuotePaymentMethodInput

Defines the payment method of the specified negotiable quote.

Input Fields

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

Example

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

SetNegotiableQuotePaymentMethodOutput

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

Fields

Field Name
Description
quote - NegotiableQuote
The updated negotiable quote.

Example

{"quote": NegotiableQuote}

SetNegotiableQuoteShippingAddressInput

Defines the shipping address to assign to the negotiable quote.

Input Fields

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

Example

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

SetNegotiableQuoteShippingAddressOutput

Contains the negotiable quote.

Fields

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

Example

{"quote": NegotiableQuote}

SetNegotiableQuoteShippingMethodsInput

Defines the shipping method to apply to the negotiable quote.

Input Fields

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

Example

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

SetNegotiableQuoteShippingMethodsOutput

Contains the negotiable quote.

Fields

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

Example

{"quote": NegotiableQuote}

SetNegotiableQuoteTemplateShippingAddressInput

Defines the shipping address to assign to the negotiable quote template.

Input Fields

Input Field
Description
shipping_address - NegotiableQuoteTemplateShippingAddressInput!
A shipping adadress to apply to the negotiable quote template.
template_id - ID!
The unique ID of a `NegotiableQuote` object.

Example

{
  "shipping_address": NegotiableQuoteTemplateShippingAddressInput,
  "template_id": 4
}

SetPaymentMethodOnCartInput

Applies a payment method to the cart.

Input Fields

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

Example

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

SetPaymentMethodOnCartOutput

Contains details about the cart after setting the payment method.

Fields

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

Example

{"cart": Cart}

SetShippingAddressesOnCartInput

Specifies an array of addresses to use for shipping.

Input Fields

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

Example

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

SetShippingAddressesOnCartOutput

Contains details about the cart after setting the shipping addresses.

Fields

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

Example

{"cart": Cart}

SetShippingMethodsOnCartInput

Applies one or shipping methods to the cart.

Input Fields

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

Example

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

SetShippingMethodsOnCartOutput

Contains details about the cart after setting the shipping methods.

Fields

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

Example

{"cart": Cart}

ShareGiftRegistryInviteeInput

Defines a gift registry invitee.

Input Fields

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

Example

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

ShareGiftRegistryOutput

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

Fields

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

Example

{"is_shared": false}

ShareGiftRegistrySenderInput

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

Input Fields

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

Example

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

ShipBundleItemsEnum

Defines whether bundle items must be shipped together.

Values

Enum Value
Description
TOGETHER
SEPARATELY

Example

""TOGETHER""

ShipmentItem

Fields

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

Example

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

ShipmentItemInterface

Order shipment item details.

Fields

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

Possible Types

Example

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

ShipmentTracking

Contains order shipment tracking details.

Fields

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

Example

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

ShippingAdditionalData

A simple key value object.

Fields

Field Name
Description
key - String
value - String

Example

{
  "key": "xyz789",
  "value": "xyz789"
}

ShippingAddressInput

Defines a single shipping address.

Input Fields

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

Example

{
  "address": CartAddressInput,
  "customer_address_id": 123,
  "customer_address_uid": 4,
  "customer_notes": "xyz789",
  "pickup_location_code": "abc123"
}

ShippingCartAddress

Contains shipping addresses and methods.

Fields

Field Name
Description
available_shipping_methods - [AvailableShippingMethod]
An array that lists the shipping methods that can be applied to the cart.
cart_items_v2 - [CartItemInterface]
An array that lists the items in the cart.
city - String!
The city specified for the billing or shipping address.
company - String
The company specified for the billing or shipping address.
country - CartAddressCountry!
An object containing the country label and code.
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.
customer_notes - String
Text provided by the shopper.
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.
pickup_location_code - String
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.
same_as_billing - Boolean!
Indicates whether the shipping address is same as billing address.
selected_shipping_method - SelectedShippingMethod
An object that describes the selected shipping method.
street - [String]!
An array containing the street for the billing or shipping address.
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

{
  "available_shipping_methods": [AvailableShippingMethod],
  "cart_items_v2": [CartItemInterface],
  "city": "xyz789",
  "company": "abc123",
  "country": CartAddressCountry,
  "custom_attributes": [AttributeValueInterface],
  "customer_address_uid": "4",
  "customer_notes": "xyz789",
  "fax": "abc123",
  "firstname": "xyz789",
  "id": 987,
  "lastname": "xyz789",
  "middlename": "xyz789",
  "pickup_location_code": "abc123",
  "postcode": "xyz789",
  "prefix": "xyz789",
  "region": CartAddressRegion,
  "same_as_billing": false,
  "selected_shipping_method": SelectedShippingMethod,
  "street": ["xyz789"],
  "suffix": "abc123",
  "telephone": "xyz789",
  "uid": "4",
  "vat_id": "abc123"
}

ShippingDiscount

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

Fields

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

Example

{"amount": Money}

ShippingHandling

Contains details about shipping and handling costs.

Fields

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

Example

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

ShippingMethodInput

Defines the shipping carrier and method.

Input Fields

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

Example

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

SimpleCartItem

An implementation for simple product cart items.

Fields

Field Name
Description
available_gift_wrapping - [GiftWrapping]!
The list of available gift wrapping options for the cart item.
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],
  "custom_attributes": [CustomAttribute],
  "customizable_options": [SelectedCustomizableOption],
  "discount": [Discount],
  "errors": [CartItemError],
  "gift_message": GiftMessage,
  "gift_wrapping": GiftWrapping,
  "is_available": false,
  "max_qty": 987.65,
  "min_qty": 987.65,
  "not_available_message": "abc123",
  "note_from_buyer": [ItemNote],
  "note_from_seller": [ItemNote],
  "prices": CartItemPrices,
  "product": ProductInterface,
  "quantity": 123.45,
  "uid": 4
}

SimpleProduct

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

Fields

Field Name
Description
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.
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
weight - Float
The weight of the item, in units defined by the store.

Example

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

SimpleProductView

Represents a single-SKU product without selectable variants. Because there are no variant combinations, pricing is returned as a single price (not a price range).

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 names and roles.
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`, and `swatch`.
videos - [ProductViewVideo]
A list of videos defined for the product.
inputOptions - [ProductViewInputOption]
A list of input options. For example, a text field, a number field or a date field. (Deprecated: This field is deprecated and will be removed.)
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.
price - ProductViewPrice
Base product price view.
shortDescription - String
A summary of the product.
sku - String
A unique code used for identification of a product.
externalId - String
External Id. For example, `123`, `456` or `789`. (Deprecated: This field is deprecated and will be removed.)
url - String
Canonical URL of the product. For example, `https://example.com/product-1` or `https://example.com/product-2`. (Deprecated: This field is deprecated and will be removed.)
urlKey - String
The URL key of the product. For example, `product-1`, `product-2` or `product-3`.
links - [ProductViewLink]
A list of product links. For example, a related product, an up-sell product or a cross-sell product.
categories - [CategoryProductView!]
A list of categories in which the product is present. Categories are used to group products by category.
queryType - String
Indicates if the product was retrieved from the primary or the backup query
visibility - String
Visibility setting of the product

Example

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

SimpleRequisitionListItem

Contains details about simple products added to a requisition list.

Fields

Field Name
Description
customizable_options - [SelectedCustomizableOption]!
Selected custom options for an item in the requisition list.
product - ProductInterface!
Details about a requisition list item. (Deprecated: Product information is part of a composable Catalog Service.)
quantity - Float!
The amount added.
sku - String!
The product SKU.
uid - ID!
The unique ID for the requisition list item.

Example

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

SimpleWishlistItem

Contains a simple product wish list item.

Fields

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

Example

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

SmartButtonMethodInput

Smart button payment 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": "xyz789",
  "paypal_order_id": "abc123"
}

SmartButtonsConfig

Fields

Field Name
Description
app_switch_when_available - Boolean
Indicated whether to use App Switch on enabled mobile devices
button_styles - ButtonStyles
The styles for the PayPal Smart Button configuration
code - String
The payment method code as defined in the payment gateway
display_message - Boolean
Indicates whether to display the PayPal Pay Later message
display_venmo - Boolean
Indicates whether to display Venmo
is_visible - Boolean
Indicates whether the payment method is displayed
message_styles - MessageStyles
Contains details about the styles for the PayPal Pay Later message
payment_intent - String
Defines the payment intent (Authorize or Capture
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

{
  "app_switch_when_available": true,
  "button_styles": ButtonStyles,
  "code": "abc123",
  "display_message": true,
  "display_venmo": false,
  "is_visible": true,
  "message_styles": MessageStyles,
  "payment_intent": "abc123",
  "sdk_params": [SDKParams],
  "sort_order": "abc123",
  "title": "xyz789"
}

SortEnum

Indicates whether to return results in ascending or descending order.

Values

Enum Value
Description
ASC
DESC

Example

""ASC""

SortField

Defines a possible sort field.

Fields

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

Example

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

SortFields

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

Fields

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

Example

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

SortQuoteItemsEnum

Specifies the field to use for sorting quote items

Values

Enum Value
Description
ITEM_ID
CREATED_AT
UPDATED_AT
PRODUCT_ID
SKU
NAME
DESCRIPTION
WEIGHT
QTY
PRICE
BASE_PRICE
CUSTOM_PRICE
DISCOUNT_PERCENT
DISCOUNT_AMOUNT
BASE_DISCOUNT_AMOUNT
TAX_PERCENT
TAX_AMOUNT
BASE_TAX_AMOUNT
ROW_TOTAL
BASE_ROW_TOTAL
ROW_TOTAL_WITH_DISCOUNT
ROW_WEIGHT
PRODUCT_TYPE
BASE_TAX_BEFORE_DISCOUNT
TAX_BEFORE_DISCOUNT
ORIGINAL_CUSTOM_PRICE
PRICE_INC_TAX
BASE_PRICE_INC_TAX
ROW_TOTAL_INC_TAX
BASE_ROW_TOTAL_INC_TAX
DISCOUNT_TAX_COMPENSATION_AMOUNT
BASE_DISCOUNT_TAX_COMPENSATION_AMOUNT
FREE_SHIPPING

Example

""ITEM_ID""

SortableAttribute

Contains product attributes that be used for sorting in a productSearch query

Fields

Field Name
Description
attribute - String!
The unique identifier for an attribute code. This value should be in lowercase letters and without space
frontendInput - String
Indicates how field rendered on storefront
label - String
The display name assigned to the attribute
numeric - Boolean
Indicates whether this attribute has a numeric value, such as a price or integer

Example

{
  "attribute": "abc123",
  "frontendInput": "xyz789",
  "label": "xyz789",
  "numeric": false
}

StatsBucket

For retrieving statistics across multiple buckets

Fields

Field Name
Description
max - Float!
The maximum value
min - Float!
The minimum value
title - String!
The display text for the bucket

Example

{
  "max": 987.65,
  "min": 987.65,
  "title": "abc123"
}