Types

FilterEqualTypeInput

Defines a filter that matches the input exactly.

Input Fields

Input Field
Description
eq - String
Use this attribute to exactly match the specified string. For example, to filter on a specific category ID, specify a value such as 5.
in - [String]
Use this attribute to filter on an array of values. For example, to filter on category IDs 4, 5, and 6, specify a value of ["4", "5", "6"].

Example

{
  "eq": "abc123",
  "in": ["xyz789"]
}

FilterMatchTypeEnum

Values

Enum Value
Description
FULL
PARTIAL

Example

""FULL""

FilterMatchTypeInput

Defines a filter that performs a fuzzy search.

Input Fields

Input Field
Description
match - String
Use this attribute to fuzzy match the specified string. For example, to filter on a specific SKU, specify a value such as 24-MB01.
match_type - FilterMatchTypeEnum
Filter match type for fine-tuned results. Possible values FULL or PARTIAL. If match_type is not provided, returned results will default to FULL match.

Example

{"match": "abc123", "match_type": "FULL"}

FilterRangeTypeInput

Defines a filter that matches a range of values, such as prices or dates.

Input Fields

Input Field
Description
from - String
Use this attribute to specify the lowest possible value in the range.
to - String
Use this attribute to specify the highest possible value in the range.

Example

{
  "from": "xyz789",
  "to": "xyz789"
}

FilterStringTypeInput

Defines a filter for an input string.

Input Fields

Input Field
Description
eq - String
Filters items that are exactly the same as the specified string.
in - [String]
Filters items that are exactly the same as entries specified in an array of strings.
match - String
Defines a filter that performs a fuzzy search using the specified string.

Example

{
  "eq": "abc123",
  "in": ["xyz789"],
  "match": "xyz789"
}

FilterTypeInput

Defines the comparison operators that can be used in a filter.

Input Fields

Input Field
Description
eq - String
Equals.
finset - [String]
from - String
From. Must be used with the to field.
gt - String
Greater than.
gteq - String
Greater than or equal to.
in - [String]
In. The value can contain a set of comma-separated values.
like - String
Like. The specified value can contain % (percent signs) to allow matching of 0 or more characters.
lt - String
Less than.
lteq - String
Less than or equal to.
moreq - String
More than or equal to.
neq - String
Not equal to.
nin - [String]
Not in. The value can contain a set of comma-separated values.
notnull - String
Not null.
null - String
Is null.
to - String
To. Must be used with the from field.

Example

{
  "eq": "abc123",
  "finset": ["abc123"],
  "from": "abc123",
  "gt": "abc123",
  "gteq": "abc123",
  "in": ["abc123"],
  "like": "abc123",
  "lt": "abc123",
  "lteq": "xyz789",
  "moreq": "xyz789",
  "neq": "xyz789",
  "nin": ["abc123"],
  "notnull": "abc123",
  "null": "xyz789",
  "to": "abc123"
}

FixedProductTax

A single FPT that can be applied to a product price.

Fields

Field Name
Description
amount - Money
The amount of the Fixed Product Tax.
label - String
The display label assigned to the Fixed Product Tax.

Example

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

FixedProductTaxDisplaySettings

Lists display settings for the Fixed Product Tax.

Values

Enum Value
Description
INCLUDE_FPT_WITHOUT_DETAILS
The displayed price includes the FPT amount without displaying the ProductPrice.fixed_product_taxes values. This value corresponds to 'Including FPT only'.
INCLUDE_FPT_WITH_DETAILS
The displayed price includes the FPT amount while displaying the values of ProductPrice.fixed_product_taxes separately. This value corresponds to 'Including FPT and FPT description'.
EXCLUDE_FPT_AND_INCLUDE_WITH_DETAILS
The displayed price does not include the FPT amount. The values of ProductPrice.fixed_product_taxes and the price including the FPT are displayed separately. This value corresponds to 'Excluding FPT, Including FPT description and final price.'
EXCLUDE_FPT_WITHOUT_DETAILS
The displayed price does not include the FPT amount. The values from ProductPrice.fixed_product_taxes are not displayed. This value corresponds to 'Excluding FPT'.
FPT_DISABLED
The FPT feature is not enabled. You can omit ProductPrice.fixed_product_taxes from your query.

Example

""INCLUDE_FPT_WITHOUT_DETAILS""

Float

The Float scalar type represents signed double-precision fractional values as specified by IEEE 754.

Example

123.45

GenerateCustomerTokenAsAdminInput

Identifies which customer requires remote shopping assistance.

Input Fields

Input Field
Description
customer_email - String!
The email address of the customer requesting remote shopping assistance.

Example

{"customer_email": "xyz789"}

GenerateCustomerTokenAsAdminOutput

Contains the generated customer token.

Fields

Field Name
Description
customer_token - String!
The generated customer token.

Example

{"customer_token": "abc123"}

GenerateNegotiableQuoteFromTemplateInput

Specifies the template id, from which to generate quote from.

Input Fields

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

Example

{"template_id": "4"}

GenerateNegotiableQuoteFromTemplateOutput

Contains the generated negotiable quote id.

Fields

Field Name
Description
negotiable_quote_uid - ID!
The unique ID of a generated NegotiableQuote object.

Example

{"negotiable_quote_uid": "4"}

GetPaymentSDKOutput

Gets the payment SDK URLs and values

Fields

Field Name
Description
sdkParams - [PaymentSDKParamsItem]
The payment SDK parameters

Example

{"sdkParams": [PaymentSDKParamsItem]}

GiftCardAccount

Contains details about the gift card account.

Fields

Field Name
Description
balance - Money
The balance remaining on the gift card.
code - String
The gift card account code.
expiration_date - String
The expiration date of the gift card.

Example

{
  "balance": Money,
  "code": "abc123",
  "expiration_date": "abc123"
}

GiftCardAccountInput

Contains the gift card code.

Input Fields

Input Field
Description
gift_card_code - String!
The applied gift card code.

Example

{"gift_card_code": "xyz789"}

GiftCardAmounts

Contains the value of a gift card, the website that generated the card, and related information.

Fields

Field Name
Description
attribute_id - Int
An internal attribute ID.
uid - ID!
The unique ID for a GiftCardAmounts object.
value - Float
The value of the gift card.
value_id - Int
An ID that is assigned to each unique gift card amount. (Deprecated: Use uid instead)
website_id - Int
The ID of the website that generated the gift card.
website_value - Float
The value of the gift card.

Example

{
  "attribute_id": 987,
  "uid": 4,
  "value": 987.65,
  "value_id": 987,
  "website_id": 987,
  "website_value": 123.45
}

GiftCardCartItem

Contains details about a gift card that has been added to a cart.

Fields

Field Name
Description
amount - Money!
The amount and currency of the gift card.
customizable_options - [SelectedCustomizableOption]!
An array of customizations applied to the gift card.
discount - [Discount]
Contains discount for quote line item.
errors - [CartItemError]
An array of errors encountered while loading the cart item
id - String!
(Deprecated: Use uid instead.)
is_available - Boolean!
True if requested quantity is less than available stock, false otherwise.
max_qty - Float
Line item max qty in quote template
message - String
The message from the sender to the recipient.
min_qty - Float
Line item min qty in quote template
note_from_buyer - [ItemNote]
The buyer's quote line item note.
note_from_seller - [ItemNote]
The seller's quote line item note.
prices - CartItemPrices
Contains details about the price of the item, including taxes and discounts.
product - ProductInterface!
Details about an item in the cart.
quantity - Float!
The quantity of this item in the cart.
recipient_email - String
The email address of the person receiving the gift card.
recipient_name - String!
The name of the person receiving the gift card.
sender_email - String
The email address of the sender.
sender_name - String!
The name of the sender.
uid - ID!
The unique ID for a CartItemInterface object.

Example

{
  "amount": Money,
  "customizable_options": [SelectedCustomizableOption],
  "discount": [Discount],
  "errors": [CartItemError],
  "id": "xyz789",
  "is_available": false,
  "max_qty": 987.65,
  "message": "xyz789",
  "min_qty": 123.45,
  "note_from_buyer": [ItemNote],
  "note_from_seller": [ItemNote],
  "prices": CartItemPrices,
  "product": ProductInterface,
  "quantity": 987.65,
  "recipient_email": "abc123",
  "recipient_name": "abc123",
  "sender_email": "xyz789",
  "sender_name": "abc123",
  "uid": "4"
}

GiftCardCreditMemoItem

Fields

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

Example

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

GiftCardInvoiceItem

Fields

Field Name
Description
discounts - [Discount]
Information about the final discount amount for the base product, including discounts on options.
gift_card - GiftCardItem
Selected gift card properties for an invoice item.
id - ID!
The unique ID for an InvoiceItemInterface object.
order_item - OrderItemInterface
Details about an individual order item.
product_name - String
The name of the base product.
product_sale_price - Money!
The sale price for the base product including selected options.
product_sku - String!
The SKU of the base product.
quantity_invoiced - Float
The number of invoiced items.

Example

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

GiftCardItem

Contains details about a gift card.

Fields

Field Name
Description
message - String
The message from the sender to the recipient.
recipient_email - String
The email address of the receiver of a virtual gift card.
recipient_name - String
The name of the receiver of a physical or virtual gift card.
sender_email - String
The email address of the sender of a virtual gift card.
sender_name - String
The name of the sender of a physical or virtual gift card.

Example

{
  "message": "abc123",
  "recipient_email": "abc123",
  "recipient_name": "abc123",
  "sender_email": "abc123",
  "sender_name": "xyz789"
}

GiftCardOptions

Contains details about the sender, recipient, and amount of a gift card.

Fields

Field Name
Description
amount - Money
The amount and currency of the gift card.
custom_giftcard_amount - Money
The custom amount and currency of the gift card.
message - String
A message to the recipient.
recipient_email - String
The email address of the person receiving the gift card.
recipient_name - String
The name of the person receiving the gift card.
sender_email - String
The email address of the person sending the gift card.
sender_name - String
The name of the person sending the gift card.

Example

{
  "amount": Money,
  "custom_giftcard_amount": Money,
  "message": "xyz789",
  "recipient_email": "xyz789",
  "recipient_name": "abc123",
  "sender_email": "xyz789",
  "sender_name": "abc123"
}

GiftCardOrderItem

Fields

Field Name
Description
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_card - GiftCardItem
Selected gift card properties for an order item.
gift_message - GiftMessage
The selected gift message for the order item
gift_wrapping - GiftWrapping
The selected gift wrapping for the order item.
id - ID!
The unique ID for an OrderItemInterface object.
product - ProductInterface
The ProductInterface object, which contains details about the base product
product_name - String
The name of the base product.
product_sale_price - Money!
The sale price of the base product, including selected options.
product_sku - String!
The SKU of the base product.
product_type - String
The type of product, such as simple, configurable, etc.
product_url_key - String
URL key of the base product.
quantity_canceled - Float
The number of canceled items.
quantity_invoiced - Float
The number of invoiced items.
quantity_ordered - Float
The number of units ordered for this item.
quantity_refunded - Float
The number of refunded items.
quantity_returned - Float
The number of returned items.
quantity_shipped - Float
The number of shipped items.
selected_options - [OrderItemOption]
The selected options for the base product, such as color or size.
status - String
The status of the order item.

Example

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

GiftCardProduct

Defines properties of a gift card.

Fields

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

Example

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

GiftCardRequisitionListItem

Contains details about gift cards added to a requisition list.

Fields

Field Name
Description
customizable_options - [SelectedCustomizableOption]!
Selected custom options for an item in the requisition list.
gift_card_options - GiftCardOptions!
An array that defines gift card properties.
product - ProductInterface!
Details about a requisition list item.
quantity - Float!
The amount added.
uid - ID!
The unique ID for the requisition list item.

Example

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

GiftCardShipmentItem

Fields

Field Name
Description
gift_card - GiftCardItem
Selected gift card properties for a shipment item.
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

{
  "gift_card": GiftCardItem,
  "id": "4",
  "order_item": OrderItemInterface,
  "product_name": "abc123",
  "product_sale_price": Money,
  "product_sku": "abc123",
  "quantity_shipped": 123.45
}

GiftCardTypeEnum

Specifies the gift card type.

Values

Enum Value
Description
VIRTUAL
PHYSICAL
COMBINED

Example

""VIRTUAL""

GiftCardWishlistItem

A single gift card added to a wish list.

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.
gift_card_options - GiftCardOptions!
Details about a gift card.
id - ID!
The unique ID for a WishlistItemInterface object.
product - ProductInterface
Product details of the wish list item.
quantity - Float!
The quantity of this wish list item.

Example

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

GiftMessage

Contains the text of a gift message, its sender, and recipient

Fields

Field Name
Description
from - String!
Sender name
message - String!
Gift message text
to - String!
Recipient name

Example

{
  "from": "abc123",
  "message": "xyz789",
  "to": "abc123"
}

GiftMessageInput

Defines a gift message.

Input Fields

Input Field
Description
from - String!
The name of the sender.
message - String!
The text of the gift message.
to - String!
The name of the recepient.

Example

{
  "from": "xyz789",
  "message": "abc123",
  "to": "abc123"
}

GiftOptionsPrices

Contains prices for gift wrapping options.

Fields

Field Name
Description
gift_wrapping_for_items - Money
Price of the gift wrapping for all individual order items.
gift_wrapping_for_order - Money
Price of the gift wrapping for the whole order.
printed_card - Money
Price for the printed card.

Example

{
  "gift_wrapping_for_items": Money,
  "gift_wrapping_for_order": Money,
  "printed_card": Money
}

GiftRegistry

Contains details about a gift registry.

Fields

Field Name
Description
created_at - String!
The date on which the gift registry was created. Only the registry owner can access this attribute.
dynamic_attributes - [GiftRegistryDynamicAttribute]
An array of attributes that define elements of the gift registry. Each attribute is specified as a code-value pair.
event_name - String!
The name of the event.
items - [GiftRegistryItemInterface]
An array of products added to the gift registry.
message - String!
The message text the customer entered to describe the event.
owner_name - String!
The customer who created the gift registry.
privacy_settings - GiftRegistryPrivacySettings!
An enum that states whether the gift registry is PRIVATE or PUBLIC. Only the registry owner can access this attribute.
registrants - [GiftRegistryRegistrant]
Contains details about each registrant for the event.
shipping_address - CustomerAddress
Contains the customer's shipping address. Only the registry owner can access this attribute.
status - GiftRegistryStatus!
An enum that states whether the gift registry is ACTIVE or INACTIVE. Only the registry owner can access this attribute.
type - GiftRegistryType
The type of gift registry.
uid - ID!
The unique ID assigned to the gift registry.

Example

{
  "created_at": "xyz789",
  "dynamic_attributes": [GiftRegistryDynamicAttribute],
  "event_name": "xyz789",
  "items": [GiftRegistryItemInterface],
  "message": "xyz789",
  "owner_name": "xyz789",
  "privacy_settings": "PRIVATE",
  "registrants": [GiftRegistryRegistrant],
  "shipping_address": CustomerAddress,
  "status": "ACTIVE",
  "type": GiftRegistryType,
  "uid": 4
}

GiftRegistryDynamicAttribute

Fields

Field Name
Description
code - ID!
The internal ID of the dynamic attribute.
group - GiftRegistryDynamicAttributeGroup!
Indicates which group the dynamic attribute is a member of.
label - String!
The display name of the dynamic attribute.
value - String!
A corresponding value for the code.

Example

{
  "code": "4",
  "group": "EVENT_INFORMATION",
  "label": "xyz789",
  "value": "abc123"
}

GiftRegistryDynamicAttributeGroup

Defines the group type of a gift registry dynamic attribute.

Values

Enum Value
Description
EVENT_INFORMATION
PRIVACY_SETTINGS
REGISTRANT
GENERAL_INFORMATION
DETAILED_INFORMATION
SHIPPING_ADDRESS

Example

""EVENT_INFORMATION""

GiftRegistryDynamicAttributeInput

Defines a dynamic attribute.

Input Fields

Input Field
Description
code - ID!
A unique key for an additional attribute of the event.
value - String!
A string that describes a dynamic attribute.

Example

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

GiftRegistryDynamicAttributeInterface

Fields

Field Name
Description
code - ID!
The internal ID of the dynamic attribute.
label - String!
The display name of the dynamic attribute.
value - String!
A corresponding value for the code.

Possible Types

GiftRegistryDynamicAttributeInterface Types
GiftRegistryRegistrantDynamicAttribute
GiftRegistryDynamicAttribute

Example

{
  "code": "4",
  "label": "xyz789",
  "value": "xyz789"
}

GiftRegistryDynamicAttributeMetadata

Fields

Field Name
Description
attribute_group - String!
Indicates which group the dynamic attribute a member of.
code - ID!
The internal ID of the dynamic attribute.
input_type - String!
The selected input type for this dynamic attribute. The value can be one of several static or custom types.
is_required - Boolean!
Indicates whether the dynamic attribute is required.
label - String!
The display name of the dynamic attribute.
sort_order - Int
The order in which to display the dynamic attribute.

Example

{
  "attribute_group": "abc123",
  "code": "4",
  "input_type": "xyz789",
  "is_required": false,
  "label": "xyz789",
  "sort_order": 123
}

GiftRegistryDynamicAttributeMetadataInterface

Fields

Field Name
Description
attribute_group - String!
Indicates which group the dynamic attribute a member of.
code - ID!
The internal ID of the dynamic attribute.
input_type - String!
The selected input type for this dynamic attribute. The value can be one of several static or custom types.
is_required - Boolean!
Indicates whether the dynamic attribute is required.
label - String!
The display name of the dynamic attribute.
sort_order - Int
The order in which to display the dynamic attribute.

Possible Types

GiftRegistryDynamicAttributeMetadataInterface Types
GiftRegistryDynamicAttributeMetadata

Example

{
  "attribute_group": "xyz789",
  "code": "4",
  "input_type": "xyz789",
  "is_required": false,
  "label": "xyz789",
  "sort_order": 123
}

GiftRegistryItem

Fields

Field Name
Description
created_at - String!
The date the product was added to the gift registry.
note - String
A brief message about the gift registry item.
product - ProductInterface
Details about the gift registry item.
quantity - Float!
The requested quantity of the product.
quantity_fulfilled - Float!
The fulfilled quantity of the product.
uid - ID!
The unique ID of a gift registry item.

Example

{
  "created_at": "abc123",
  "note": "xyz789",
  "product": ProductInterface,
  "quantity": 123.45,
  "quantity_fulfilled": 123.45,
  "uid": 4
}

GiftRegistryItemInterface

Fields

Field Name
Description
created_at - String!
The date the product was added to the gift registry.
note - String
A brief message about the gift registry item.
product - ProductInterface
Details about the gift registry item.
quantity - Float!
The requested quantity of the product.
quantity_fulfilled - Float!
The fulfilled quantity of the product.
uid - ID!
The unique ID of a gift registry item.

Possible Types

GiftRegistryItemInterface Types
GiftRegistryItem

Example

{
  "created_at": "abc123",
  "note": "abc123",
  "product": ProductInterface,
  "quantity": 123.45,
  "quantity_fulfilled": 123.45,
  "uid": "4"
}

GiftRegistryItemUserErrorInterface

Contains the status and any errors that encountered with the customer's gift register item.

Fields

Field Name
Description
status - Boolean!
Indicates whether the attempt to move the cart items to the gift registry was successful.
user_errors - [GiftRegistryItemsUserError]!
An array of errors encountered while moving items from the cart to the gift registry.

Possible Types

GiftRegistryItemUserErrorInterface Types
MoveCartItemsToGiftRegistryOutput

Example

{
  "status": true,
  "user_errors": [GiftRegistryItemsUserError]
}

GiftRegistryItemsUserError

Contains details about an error that occurred when processing a gift registry item.

Fields

Field Name
Description
code - GiftRegistryItemsUserErrorType!
An error code that describes the error encountered.
gift_registry_item_uid - ID
The unique ID of the gift registry item containing an error.
gift_registry_uid - ID
The unique ID of the GiftRegistry object containing an error.
message - String!
A localized error message.
product_uid - ID
The unique ID of the product containing an error.

Example

{
  "code": "OUT_OF_STOCK",
  "gift_registry_item_uid": "4",
  "gift_registry_uid": 4,
  "message": "xyz789",
  "product_uid": "4"
}

GiftRegistryItemsUserErrorType

Defines the error type.

Values

Enum Value
Description
OUT_OF_STOCK
Used for handling out of stock products.
NOT_FOUND
Used for exceptions like EntityNotFound.
UNDEFINED
Used for other exceptions, such as database connection failures.

Example

""OUT_OF_STOCK""

GiftRegistryOutputInterface

Contains the customer's gift registry.

Fields

Field Name
Description
gift_registry - GiftRegistry
The gift registry.

Possible Types

GiftRegistryOutputInterface Types
MoveCartItemsToGiftRegistryOutput

Example

{"gift_registry": GiftRegistry}

GiftRegistryPrivacySettings

Defines the privacy setting of the gift registry.

Values

Enum Value
Description
PRIVATE
PUBLIC

Example

""PRIVATE""

GiftRegistryRegistrant

Contains details about a registrant.

Fields

Field Name
Description
dynamic_attributes - [GiftRegistryRegistrantDynamicAttribute]
An array of dynamic attributes assigned to the registrant.
email - String!
The email address of the registrant. Only the registry owner can access this attribute.
firstname - String!
The first name of the registrant.
lastname - String!
The last name of the registrant.
uid - ID!
The unique ID assigned to the registrant.

Example

{
  "dynamic_attributes": [
    GiftRegistryRegistrantDynamicAttribute
  ],
  "email": "abc123",
  "firstname": "xyz789",
  "lastname": "xyz789",
  "uid": 4
}

GiftRegistryRegistrantDynamicAttribute

Fields

Field Name
Description
code - ID!
The internal ID of the dynamic attribute.
label - String!
The display name of the dynamic attribute.
value - String!
A corresponding value for the code.

Example

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

GiftRegistrySearchResult

Contains the results of a gift registry search.

Fields

Field Name
Description
event_date - String
The date of the event.
event_title - String!
The title given to the event.
gift_registry_uid - ID!
The URL key of the gift registry.
location - String
The location of the event.
name - String!
The name of the gift registry owner.
type - String
The type of event being held.

Example

{
  "event_date": "xyz789",
  "event_title": "abc123",
  "gift_registry_uid": 4,
  "location": "xyz789",
  "name": "xyz789",
  "type": "xyz789"
}

GiftRegistryShippingAddressInput

Defines a shipping address for a gift registry. Specify either address_data or the address_id. If both are provided, validation will fail.

Input Fields

Input Field
Description
address_data - CustomerAddressInput
Defines the shipping address for this gift registry.
address_id - ID
The ID assigned to this customer address.

Example

{"address_data": CustomerAddressInput, "address_id": 4}

GiftRegistryStatus

Defines the status of the gift registry.

Values

Enum Value
Description
ACTIVE
INACTIVE

Example

""ACTIVE""

GiftRegistryType

Contains details about a gift registry type.

Fields

Field Name
Description
dynamic_attributes_metadata - [GiftRegistryDynamicAttributeMetadataInterface]
An array of attributes that define elements of the gift registry. Each attribute is specified as a code-value pair.
label - String!
The label assigned to the gift registry type on the Admin.
uid - ID!
The unique ID assigned to the gift registry type.

Example

{
  "dynamic_attributes_metadata": [
    GiftRegistryDynamicAttributeMetadataInterface
  ],
  "label": "xyz789",
  "uid": "4"
}

GiftWrapping

Contains details about the selected or available gift wrapping options.

Fields

Field Name
Description
design - String!
The name of the gift wrapping design.
id - ID!
The unique ID for a GiftWrapping object. (Deprecated: Use uid instead)
image - GiftWrappingImage
The preview image for a gift wrapping option.
price - Money!
The gift wrapping price.
uid - ID!
The unique ID for a GiftWrapping object.

Example

{
  "design": "abc123",
  "id": 4,
  "image": GiftWrappingImage,
  "price": Money,
  "uid": "4"
}

GiftWrappingImage

Points to an image associated with a gift wrapping option.

Fields

Field Name
Description
label - String!
The gift wrapping preview image label.
url - String!
The gift wrapping preview image URL.

Example

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

GooglePayButtonStyles

Fields

Field Name
Description
color - String
The button color
height - Int
The button height in pixels
type - String
The button type

Example

{
  "color": "abc123",
  "height": 987,
  "type": "abc123"
}

GooglePayConfig

Fields

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

Example

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

GooglePayMethodInput

Google Pay inputs

Input Fields

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

Example

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

GroupedProduct

Defines a grouped product, which consists of simple standalone products that are presented as a group.

Fields

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

Example

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

GroupedProductItem

Contains information about an individual grouped product item.

Fields

Field Name
Description
position - Int
The relative position of this item compared to the other group items.
product - ProductInterface
Details about this product option.
qty - Float
The quantity of this grouped product item.

Example

{
  "position": 123,
  "product": ProductInterface,
  "qty": 987.65
}

GroupedProductWishlistItem

A grouped product wish list item.

Fields

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

Example

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

HostedFieldsConfig

Fields

Field Name
Description
cc_vault_code - String
Vault payment method code
code - String
The payment method code as defined in the payment gateway
is_vault_enabled - Boolean
Card vault enabled
is_visible - Boolean
Indicates whether the payment method is displayed
payment_intent - String
Defines the payment intent (Authorize or Capture
payment_source - String
The payment source for the payment method
requires_card_details - Boolean
Card and bin details required
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
three_ds - Boolean
3DS mode
title - String
The name displayed for the payment method

Example

{
  "cc_vault_code": "xyz789",
  "code": "xyz789",
  "is_vault_enabled": true,
  "is_visible": true,
  "payment_intent": "abc123",
  "payment_source": "xyz789",
  "requires_card_details": true,
  "sdk_params": [SDKParams],
  "sort_order": "xyz789",
  "three_ds": true,
  "title": "abc123"
}

HostedFieldsInput

Hosted Fields payment inputs

Input Fields

Input Field
Description
cardBin - String
Card bin number
cardExpiryMonth - String
Expiration month of the card
cardExpiryYear - String
Expiration year of the card
cardLast4 - String
Last four digits of the card
holderName - String
Name on the card
is_active_payment_token_enabler - Boolean
Indicates whether details about the shopper's credit/debit card should be tokenized for later usage. Required only if Vault is enabled for the Payment Services payment integration.
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

{
  "cardBin": "xyz789",
  "cardExpiryMonth": "xyz789",
  "cardExpiryYear": "xyz789",
  "cardLast4": "xyz789",
  "holderName": "abc123",
  "is_active_payment_token_enabler": false,
  "payment_source": "xyz789",
  "payments_order_id": "abc123",
  "paypal_order_id": "abc123"
}

HostedProInput

Contains a set of relative URLs that PayPal uses in response to various actions during the authorization process. Magento prepends the base URL to this value to create a full URL. For example, if the full URL is https://www.example.com/path/to/page.html, the relative URL is path/to/page.html. Use this input for Payments Pro Hosted Solution payment method.

Input Fields

Input Field
Description
cancel_url - String!
The relative URL of the page that PayPal redirects to when the buyer cancels the transaction in order to choose a different payment method. For example, if the full URL to this page is https://www.example.com/paypal/action/cancel.html, the relative URL is paypal/action/cancel.html.
return_url - String!
The relative URL of the final confirmation page that PayPal redirects to upon payment success. For example, if the full URL to this page is https://www.example.com/paypal/action/return.html, the relative URL is paypal/action/return.html.

Example

{
  "cancel_url": "xyz789",
  "return_url": "xyz789"
}

HostedProUrl

Contains the secure URL used for the Payments Pro Hosted Solution payment method.

Fields

Field Name
Description
secure_form_url - String
The secure URL generated by PayPal.

Example

{"secure_form_url": "xyz789"}

HostedProUrlInput

Contains the required input to request the secure URL for Payments Pro Hosted Solution payment.

Input Fields

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

Example

{"cart_id": "xyz789"}

HttpQueryParameter

Contains target path parameters.

Fields

Field Name
Description
name - String
A parameter name.
value - String
A parameter value.

Example

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

ID

The ID scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "4") or integer (such as 4) input value will be accepted as an ID.

Example

"4"

ImageSwatchData

Fields

Field Name
Description
thumbnail - String
The URL assigned to the thumbnail of the swatch image.
value - String
The value can be represented as color (HEX code), image link, or text.

Example

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

InputFilterEnum

List of templates/filters applied to customer attribute input.

Values

Enum Value
Description
NONE
There are no templates or filters to be applied.
DATE
Forces attribute input to follow the date format.
TRIM
Strip whitespace (or other characters) from the beginning and end of the input.
STRIPTAGS
Strip HTML Tags.
ESCAPEHTML
Escape HTML Entities.

Example

""NONE""

Int

The Int scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.

Example

123

InternalError

Contains an error message when an internal error occurred.

Fields

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

Example

{"message": "abc123"}

Invoice

Contains invoice details.

Fields

Field Name
Description
comments - [SalesCommentItem]
Comments on the invoice.
id - ID!
The unique ID for a Invoice object.
items - [InvoiceItemInterface]
Invoiced product details.
number - String!
Sequential invoice number.
total - InvoiceTotal
Invoice total amount details.

Example

{
  "comments": [SalesCommentItem],
  "id": 4,
  "items": [InvoiceItemInterface],
  "number": "xyz789",
  "total": InvoiceTotal
}

InvoiceItem

Fields

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

Example

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

InvoiceItemInterface

Contains detailes about invoiced items.

Fields

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

Possible Types

Example

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

InvoiceTotal

Contains price details from an invoice.

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 invoice.
grand_total - Money!
The final total amount, including shipping, discounts, and taxes.
shipping_handling - ShippingHandling
Details about the shipping and handling costs for the invoice.
subtotal - Money!
The subtotal of the invoice, excluding shipping, discounts, and taxes.
taxes - [TaxItem]
The invoice tax details.
total_shipping - Money!
The shipping amount for the invoice.
total_tax - Money!
The amount of tax applied to the invoice.

Example

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

IsCompanyAdminEmailAvailableOutput

Contains the response of a company admin email validation query.

Fields

Field Name
Description
is_email_available - Boolean!
Indicates whether the specified email address can be used to create a company administrator.

Example

{"is_email_available": true}

IsCompanyEmailAvailableOutput

Contains the response of a company email validation query.

Fields

Field Name
Description
is_email_available - Boolean!
Indicates whether the specified email address can be used to create a company.

Example

{"is_email_available": false}

IsCompanyRoleNameAvailableOutput

Contains the response of a role name validation query.

Fields

Field Name
Description
is_role_name_available - Boolean!
Indicates whether the specified company role name is available.

Example

{"is_role_name_available": false}

IsCompanyUserEmailAvailableOutput

Contains the response of a company user email validation query.

Fields

Field Name
Description
is_email_available - Boolean!
Indicates whether the specified email address can be used to create a company user.

Example

{"is_email_available": true}

IsEmailAvailableOutput

Contains the result of the isEmailAvailable query.

Fields

Field Name
Description
is_email_available - Boolean
Indicates whether the specified email address can be used to create a customer.

Example

{"is_email_available": true}

ItemNote

The note object for quote line item.

Fields

Field Name
Description
created_at - String
Timestamp that reflects note creation date.
creator_id - Int
ID of the user who submitted a note.
creator_type - Int
Type of teh user who submitted a note.
negotiable_quote_item_uid - ID
The unique ID of a CartItemInterface object.
note - String
Note text.
note_uid - ID
The unique ID of a ItemNote object.

Example

{
  "created_at": "xyz789",
  "creator_id": 987,
  "creator_type": 123,
  "negotiable_quote_item_uid": "4",
  "note": "xyz789",
  "note_uid": 4
}

ItemSelectedBundleOption

A list of options of the selected bundle product.

Fields

Field Name
Description
id - ID!
The unique ID for a ItemSelectedBundleOption object. (Deprecated: Use uid instead.)
label - String!
The label of the option.
uid - ID!
The unique ID for a ItemSelectedBundleOption object.
values - [ItemSelectedBundleOptionValue]
A list of products that represent the values of the parent option.

Example

{
  "id": 4,
  "label": "abc123",
  "uid": 4,
  "values": [ItemSelectedBundleOptionValue]
}

ItemSelectedBundleOptionValue

A list of values for the selected bundle product.

Fields

Field Name
Description
id - ID!
The unique ID for a ItemSelectedBundleOptionValue object. (Deprecated: Use uid instead.)
price - Money!
The price of the child bundle product.
product_name - String!
The name of the child bundle product.
product_sku - String!
The SKU of the child bundle product.
quantity - Float!
The number of this bundle product that were ordered.
uid - ID!
The unique ID for a ItemSelectedBundleOptionValue object.

Example

{
  "id": 4,
  "price": Money,
  "product_name": "xyz789",
  "product_sku": "abc123",
  "quantity": 987.65,
  "uid": "4"
}