Types

FilterEqualTypeInput

Defines a filter that matches the input exactly.

Input Fields

Example

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

FilterMatchTypeInput

Defines a filter that performs a fuzzy search.

Input Fields

Example

{"match": "xyz789"}

FilterRangeTypeInput

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

Input Fields

Example

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

FilterStringTypeInput

Defines a filter for an input string.

Input Fields

Example

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

FilterTypeInput

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

Input Fields

Example

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

FixedProductTax

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

Fields

Example

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

FixedProductTaxDisplaySettings

Lists display settings for the Fixed Product Tax.

Values

Example

""INCLUDE_FPT_WITHOUT_DETAILS""

Float

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

Example

987.65

GenerateCustomerTokenAsAdminInput

Identifies which customer requires remote shopping assistance.

Input Fields

Example

{"customer_email": "abc123"}

GenerateCustomerTokenAsAdminOutput

Contains the generated customer token.

Fields

Example

{"customer_token": "abc123"}

GiftCardAccount

Contains details about the gift card account.

Fields

Example

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

GiftCardAccountInput

Contains the gift card code.

Input Fields

Example

{"gift_card_code": "abc123"}

GiftCardAmounts

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

Fields

Example

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

GiftCardCartItem

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

Fields

Example

{
  "amount": Money,
  "customizable_options": [SelectedCustomizableOption],
  "errors": [CartItemError],
  "id": "abc123",
  "message": "xyz789",
  "prices": CartItemPrices,
  "product": ProductInterface,
  "quantity": 987.65,
  "recipient_email": "abc123",
  "recipient_name": "abc123",
  "sender_email": "xyz789",
  "sender_name": "xyz789",
  "uid": 4
}

GiftCardCreditMemoItem

Fields

Example

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

GiftCardInvoiceItem

Fields

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

Example

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

GiftCardOptions

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

Fields

Example

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

GiftCardOrderItem

Fields

Example

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

GiftCardProduct

Defines properties of a gift card.

Fields

Example

{
  "activity": "xyz789",
  "allow_message": false,
  "allow_open_amount": false,
  "attribute_set_id": 123,
  "canonical_url": "xyz789",
  "categories": [CategoryInterface],
  "category_gear": "xyz789",
  "climate": "abc123",
  "collar": "abc123",
  "color": 987,
  "country_of_manufacture": "abc123",
  "created_at": "xyz789",
  "crosssell_products": [ProductInterface],
  "description": ComplexTextValue,
  "eco_collection": 123,
  "erin_recommends": 123,
  "features_bags": "xyz789",
  "format": 123,
  "gender": "abc123",
  "gift_card_options": [CustomizableOptionInterface],
  "gift_message_available": "xyz789",
  "giftcard_amounts": [GiftCardAmounts],
  "giftcard_type": "VIRTUAL",
  "id": 123,
  "image": ProductImage,
  "is_redeemable": true,
  "is_returnable": "abc123",
  "lifetime": 123,
  "manufacturer": 123,
  "material": "abc123",
  "media_gallery": [MediaGalleryInterface],
  "media_gallery_entries": [MediaGalleryEntry],
  "message_max_length": 123,
  "meta_description": "xyz789",
  "meta_keyword": "abc123",
  "meta_title": "abc123",
  "name": "xyz789",
  "new": 987,
  "new_from_date": "xyz789",
  "new_to_date": "abc123",
  "only_x_left_in_stock": 987.65,
  "open_amount_max": 987.65,
  "open_amount_min": 987.65,
  "options": [CustomizableOptionInterface],
  "options_container": "xyz789",
  "pattern": "xyz789",
  "performance_fabric": 987,
  "price": ProductPrices,
  "price_range": PriceRange,
  "price_tiers": [TierPrice],
  "product_links": [ProductLinksInterface],
  "purpose": 987,
  "rating_summary": 123.45,
  "redirect_code": 987,
  "related_products": [ProductInterface],
  "relative_url": "abc123",
  "review_count": 987,
  "reviews": ProductReviews,
  "sale": 987,
  "short_description": ComplexTextValue,
  "size": 987,
  "sku": "xyz789",
  "sleeve": "abc123",
  "small_image": ProductImage,
  "special_from_date": "xyz789",
  "special_price": 123.45,
  "special_to_date": "xyz789",
  "staged": false,
  "stock_status": "IN_STOCK",
  "strap_bags": "abc123",
  "style_bags": "xyz789",
  "style_bottom": "abc123",
  "style_general": "abc123",
  "swatch_image": "xyz789",
  "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": 123.45
}

GiftCardRequisitionListItem

Contains details about gift cards added to a requisition list.

Fields

Example

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

GiftCardShipmentItem

Fields

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

Example

""VIRTUAL""

GiftCardWishlistItem

A single gift card added to a wish list.

Fields

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

Example

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

GiftMessageInput

Defines a gift message.

Input Fields

Example

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

GiftOptionsPrices

Contains prices for gift wrapping options.

Fields

Example

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

GiftRegistry

Contains details about a gift registry.

Fields

Example

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

GiftRegistryDynamicAttribute

Fields

Example

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

GiftRegistryDynamicAttributeGroup

Defines the group type of a gift registry dynamic attribute.

Values

Example

""EVENT_INFORMATION""

GiftRegistryDynamicAttributeInput

Defines a dynamic attribute.

Input Fields

Example

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

GiftRegistryDynamicAttributeInterface

Fields

Possible Types

Example

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

GiftRegistryDynamicAttributeMetadata

Fields

Example

{
  "attribute_group": "xyz789",
  "code": 4,
  "input_type": "abc123",
  "is_required": true,
  "label": "xyz789",
  "sort_order": 987
}

GiftRegistryDynamicAttributeMetadataInterface

Fields

Possible Types

Example

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

GiftRegistryItem

Fields

Example

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

GiftRegistryItemInterface

Fields

Possible Types

Example

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

GiftRegistryItemUserErrorInterface

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

Fields

Possible Types

Example

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

GiftRegistryItemsUserError

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

Fields

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

Example

""OUT_OF_STOCK""

GiftRegistryOutputInterface

Contains the customer's gift registry.

Fields

Possible Types

Example

{"gift_registry": GiftRegistry}

GiftRegistryPrivacySettings

Defines the privacy setting of the gift registry.

Values

Example

""PRIVATE""

GiftRegistryRegistrant

Contains details about a registrant.

Fields

Example

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

GiftRegistryRegistrantDynamicAttribute

Fields

Example

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

GiftRegistrySearchResult

Contains the results of a gift registry search.

Fields

Example

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

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

Example

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

GiftRegistryStatus

Defines the status of the gift registry.

Values

Example

""ACTIVE""

GiftRegistryType

Contains details about a gift registry type.

Fields

Example

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

GiftWrapping

Contains details about the selected or available gift wrapping options.

Fields

Example

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

GiftWrappingImage

Points to an image associated with a gift wrapping option.

Fields

Example

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

GroupedProduct

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

Fields

Example

{
  "activity": "xyz789",
  "attribute_set_id": 123,
  "canonical_url": "xyz789",
  "categories": [CategoryInterface],
  "category_gear": "abc123",
  "climate": "abc123",
  "collar": "abc123",
  "color": 987,
  "country_of_manufacture": "xyz789",
  "created_at": "xyz789",
  "crosssell_products": [ProductInterface],
  "description": ComplexTextValue,
  "eco_collection": 987,
  "erin_recommends": 123,
  "features_bags": "xyz789",
  "format": 123,
  "gender": "abc123",
  "gift_message_available": "abc123",
  "id": 987,
  "image": ProductImage,
  "is_returnable": "abc123",
  "items": [GroupedProductItem],
  "manufacturer": 123,
  "material": "abc123",
  "media_gallery": [MediaGalleryInterface],
  "media_gallery_entries": [MediaGalleryEntry],
  "meta_description": "abc123",
  "meta_keyword": "xyz789",
  "meta_title": "abc123",
  "name": "xyz789",
  "new": 987,
  "new_from_date": "xyz789",
  "new_to_date": "abc123",
  "only_x_left_in_stock": 987.65,
  "options_container": "abc123",
  "pattern": "xyz789",
  "performance_fabric": 987,
  "price": ProductPrices,
  "price_range": PriceRange,
  "price_tiers": [TierPrice],
  "product_links": [ProductLinksInterface],
  "purpose": 987,
  "rating_summary": 987.65,
  "redirect_code": 123,
  "related_products": [ProductInterface],
  "relative_url": "abc123",
  "review_count": 987,
  "reviews": ProductReviews,
  "sale": 123,
  "short_description": ComplexTextValue,
  "size": 987,
  "sku": "xyz789",
  "sleeve": "xyz789",
  "small_image": ProductImage,
  "special_from_date": "xyz789",
  "special_price": 987.65,
  "special_to_date": "xyz789",
  "staged": false,
  "stock_status": "IN_STOCK",
  "strap_bags": "abc123",
  "style_bags": "abc123",
  "style_bottom": "abc123",
  "style_general": "xyz789",
  "swatch_image": "xyz789",
  "thumbnail": ProductImage,
  "tier_price": 123.45,
  "tier_prices": [ProductTierPrices],
  "type": "CMS_PAGE",
  "type_id": "abc123",
  "uid": "4",
  "updated_at": "abc123",
  "upsell_products": [ProductInterface],
  "url_key": "xyz789",
  "url_path": "xyz789",
  "url_rewrites": [UrlRewrite],
  "url_suffix": "xyz789",
  "websites": [Website],
  "weight": 987.65
}

GroupedProductItem

Contains information about an individual grouped product item.

Fields

Example

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

GroupedProductWishlistItem

A grouped product wish list item.

Fields

Example

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

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

Example

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

HostedProUrl

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

Fields

Example

{"secure_form_url": "abc123"}

HostedProUrlInput

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

Input Fields

Example

{"cart_id": "xyz789"}

HttpQueryParameter

Contains target path parameters.

Fields

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

Example

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

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

Example

{"message": "abc123"}

Invoice

Contains invoice details.

Fields

Example

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

InvoiceItem

Fields

Example

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

InvoiceItemInterface

Contains detailes about invoiced items.

Fields

Possible Types

Example

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

InvoiceTotal

Contains price details from an invoice.

Fields

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

Example

{"is_email_available": true}

IsCompanyEmailAvailableOutput

Contains the response of a company email validation query.

Fields

Example

{"is_email_available": true}

IsCompanyRoleNameAvailableOutput

Contains the response of a role name validation query.

Fields

Example

{"is_role_name_available": true}

IsCompanyUserEmailAvailableOutput

Contains the response of a company user email validation query.

Fields

Example

{"is_email_available": false}

IsEmailAvailableOutput

Contains the result of the isEmailAvailable query.

Fields

Example

{"is_email_available": false}

ItemSelectedBundleOption

A list of options of the selected bundle product.

Fields

Example

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

ItemSelectedBundleOptionValue

A list of values for the selected bundle product.

Fields

Example

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