The Adobe Commerce GraphQL API allows you to quickly and efficiently transfer information between your Commerce store and your storefront. The schema documented here is autogenerated from an instance of Adobe Commerce with B2B. You can find examples of each query and mutation in the main GraphQL documentation.
API endpoint
https://<your-store>/graphql
Headers
For header information, refer to GraphQL headers.
Version
2.4.6
Queries
availableStores
Get a list of available store views and their config information.
Response: [StoreConfig]
Arguments
useCurrentGroup - BooleanExample
Query
query availableStores($useCurrentGroup: Boolean) {
availableStores(useCurrentGroup: $useCurrentGroup) {
absolute_footer
allow_gift_receipt
allow_gift_wrapping_on_order
allow_gift_wrapping_on_order_items
allow_guests_to_write_product_reviews
allow_items
allow_order
allow_printed_card
autocomplete_on_storefront
base_currency_code
base_link_url
base_media_url
base_static_url
base_url
braintree_cc_vault_active
cart_gift_wrapping
cart_printed_card
catalog_default_sort_by
category_fixed_product_tax_display_setting
category_url_suffix
check_money_order_enable_for_specific_countries
check_money_order_enabled
check_money_order_make_check_payable_to
check_money_order_max_order_total
check_money_order_min_order_total
check_money_order_new_order_status
check_money_order_payment_from_specific_countries
check_money_order_send_check_to
check_money_order_sort_order
check_money_order_title
cms_home_page
cms_no_cookies
cms_no_route
code
configurable_thumbnail_source
copyright
default_description
default_display_currency_code
default_keywords
default_title
demonotice
enable_multiple_wishlists
front
grid_per_page
grid_per_page_values
head_includes
head_shortcut_icon
header_logo_src
id
is_default_store
is_default_store_group
is_negotiable_quote_active
is_requisition_list_active
list_mode
list_per_page
list_per_page_values
locale
logo_alt
logo_height
logo_width
magento_reward_general_is_enabled
magento_reward_general_is_enabled_on_front
magento_reward_general_min_points_balance
magento_reward_general_publish_history
magento_reward_points_invitation_customer
magento_reward_points_invitation_customer_limit
magento_reward_points_invitation_order
magento_reward_points_invitation_order_limit
magento_reward_points_newsletter
magento_reward_points_order
magento_reward_points_register
magento_reward_points_review
magento_reward_points_review_limit
magento_wishlist_general_is_enabled
maximum_number_of_wishlists
minimum_password_length
no_route
payment_payflowpro_cc_vault_active
printed_card_price
product_fixed_product_tax_display_setting
product_reviews_enabled
product_url_suffix
required_character_classes_number
returns_enabled
root_category_id
root_category_uid
sales_fixed_product_tax_display_setting
sales_gift_wrapping
sales_printed_card
secure_base_link_url
secure_base_media_url
secure_base_static_url
secure_base_url
send_friend {
...SendFriendConfigurationFragment
}
show_cms_breadcrumbs
store_code
store_group_code
store_group_name
store_name
store_sort_order
timezone
title_prefix
title_separator
title_suffix
use_store_in_url
website_code
website_id
website_name
weight_unit
welcome
zero_subtotal_enable_for_specific_countries
zero_subtotal_enabled
zero_subtotal_new_order_status
zero_subtotal_payment_action
zero_subtotal_payment_from_specific_countries
zero_subtotal_sort_order
zero_subtotal_title
}
}
Variables
{"useCurrentGroup": false}
Response
{
"data": {
"availableStores": [
{
"absolute_footer": "abc123",
"allow_gift_receipt": "abc123",
"allow_gift_wrapping_on_order": "xyz789",
"allow_gift_wrapping_on_order_items": "xyz789",
"allow_guests_to_write_product_reviews": "xyz789",
"allow_items": "abc123",
"allow_order": "abc123",
"allow_printed_card": "xyz789",
"autocomplete_on_storefront": true,
"base_currency_code": "abc123",
"base_link_url": "abc123",
"base_media_url": "abc123",
"base_static_url": "abc123",
"base_url": "xyz789",
"braintree_cc_vault_active": "xyz789",
"cart_gift_wrapping": "abc123",
"cart_printed_card": "xyz789",
"catalog_default_sort_by": "xyz789",
"category_fixed_product_tax_display_setting": "INCLUDE_FPT_WITHOUT_DETAILS",
"category_url_suffix": "xyz789",
"check_money_order_enable_for_specific_countries": false,
"check_money_order_enabled": false,
"check_money_order_make_check_payable_to": "xyz789",
"check_money_order_max_order_total": "xyz789",
"check_money_order_min_order_total": "xyz789",
"check_money_order_new_order_status": "xyz789",
"check_money_order_payment_from_specific_countries": "xyz789",
"check_money_order_send_check_to": "abc123",
"check_money_order_sort_order": 987,
"check_money_order_title": "abc123",
"cms_home_page": "xyz789",
"cms_no_cookies": "abc123",
"cms_no_route": "abc123",
"code": "xyz789",
"configurable_thumbnail_source": "abc123",
"copyright": "xyz789",
"default_description": "abc123",
"default_display_currency_code": "abc123",
"default_keywords": "abc123",
"default_title": "abc123",
"demonotice": 987,
"enable_multiple_wishlists": "xyz789",
"front": "abc123",
"grid_per_page": 987,
"grid_per_page_values": "xyz789",
"head_includes": "xyz789",
"head_shortcut_icon": "abc123",
"header_logo_src": "xyz789",
"id": 123,
"is_default_store": false,
"is_default_store_group": true,
"is_negotiable_quote_active": true,
"is_requisition_list_active": "abc123",
"list_mode": "abc123",
"list_per_page": 123,
"list_per_page_values": "abc123",
"locale": "abc123",
"logo_alt": "xyz789",
"logo_height": 987,
"logo_width": 123,
"magento_reward_general_is_enabled": "xyz789",
"magento_reward_general_is_enabled_on_front": "xyz789",
"magento_reward_general_min_points_balance": "abc123",
"magento_reward_general_publish_history": "xyz789",
"magento_reward_points_invitation_customer": "xyz789",
"magento_reward_points_invitation_customer_limit": "abc123",
"magento_reward_points_invitation_order": "abc123",
"magento_reward_points_invitation_order_limit": "xyz789",
"magento_reward_points_newsletter": "abc123",
"magento_reward_points_order": "xyz789",
"magento_reward_points_register": "abc123",
"magento_reward_points_review": "xyz789",
"magento_reward_points_review_limit": "xyz789",
"magento_wishlist_general_is_enabled": "xyz789",
"maximum_number_of_wishlists": "xyz789",
"minimum_password_length": "xyz789",
"no_route": "abc123",
"payment_payflowpro_cc_vault_active": "abc123",
"printed_card_price": "xyz789",
"product_fixed_product_tax_display_setting": "INCLUDE_FPT_WITHOUT_DETAILS",
"product_reviews_enabled": "abc123",
"product_url_suffix": "abc123",
"required_character_classes_number": "abc123",
"returns_enabled": "abc123",
"root_category_id": 123,
"root_category_uid": 4,
"sales_fixed_product_tax_display_setting": "INCLUDE_FPT_WITHOUT_DETAILS",
"sales_gift_wrapping": "abc123",
"sales_printed_card": "xyz789",
"secure_base_link_url": "abc123",
"secure_base_media_url": "xyz789",
"secure_base_static_url": "abc123",
"secure_base_url": "abc123",
"send_friend": SendFriendConfiguration,
"show_cms_breadcrumbs": 987,
"store_code": "4",
"store_group_code": 4,
"store_group_name": "abc123",
"store_name": "xyz789",
"store_sort_order": 987,
"timezone": "xyz789",
"title_prefix": "xyz789",
"title_separator": "xyz789",
"title_suffix": "xyz789",
"use_store_in_url": true,
"website_code": 4,
"website_id": 987,
"website_name": "abc123",
"weight_unit": "xyz789",
"welcome": "abc123",
"zero_subtotal_enable_for_specific_countries": false,
"zero_subtotal_enabled": true,
"zero_subtotal_new_order_status": "xyz789",
"zero_subtotal_payment_action": "abc123",
"zero_subtotal_payment_from_specific_countries": "xyz789",
"zero_subtotal_sort_order": 987,
"zero_subtotal_title": "xyz789"
}
]
}
}
cart
Return information about the specified shopping cart.
Response: Cart
Arguments
cart_id - String!Example
Query
query cart($cart_id: String!) {
cart(cart_id: $cart_id) {
applied_coupon {
...AppliedCouponFragment
}
applied_coupons {
...AppliedCouponFragment
}
applied_gift_cards {
...AppliedGiftCardFragment
}
applied_reward_points {
...RewardPointsAmountFragment
}
applied_store_credit {
...AppliedStoreCreditFragment
}
available_gift_wrappings {
...GiftWrappingFragment
}
available_payment_methods {
...AvailablePaymentMethodFragment
}
billing_address {
...BillingCartAddressFragment
}
email
gift_message {
...GiftMessageFragment
}
gift_receipt_included
gift_wrapping {
...GiftWrappingFragment
}
id
is_virtual
items {
...CartItemInterfaceFragment
}
prices {
...CartPricesFragment
}
printed_card_included
selected_payment_method {
...SelectedPaymentMethodFragment
}
shipping_addresses {
...ShippingCartAddressFragment
}
total_quantity
}
}
Variables
{"cart_id": "xyz789"}
Response
{
"data": {
"cart": {
"applied_coupon": AppliedCoupon,
"applied_coupons": [AppliedCoupon],
"applied_gift_cards": [AppliedGiftCard],
"applied_reward_points": RewardPointsAmount,
"applied_store_credit": AppliedStoreCredit,
"available_gift_wrappings": [GiftWrapping],
"available_payment_methods": [
AvailablePaymentMethod
],
"billing_address": BillingCartAddress,
"email": "abc123",
"gift_message": GiftMessage,
"gift_receipt_included": false,
"gift_wrapping": GiftWrapping,
"id": "4",
"is_virtual": true,
"items": [CartItemInterface],
"prices": CartPrices,
"printed_card_included": false,
"selected_payment_method": SelectedPaymentMethod,
"shipping_addresses": [ShippingCartAddress],
"total_quantity": 123.45
}
}
}
categories
Return a list of categories that match the specified filter.
Response: CategoryResult
Arguments
filters - CategoryFilterInputpageSize - Int20currentPage - Int1Example
Query
query categories(
$filters: CategoryFilterInput,
$pageSize: Int,
$currentPage: Int
) {
categories(
filters: $filters,
pageSize: $pageSize,
currentPage: $currentPage
) {
items {
...CategoryTreeFragment
}
page_info {
...SearchResultPageInfoFragment
}
total_count
}
}
Variables
{
"filters": CategoryFilterInput,
"pageSize": 20,
"currentPage": 1
}
Response
{
"data": {
"categories": {
"items": [CategoryTree],
"page_info": SearchResultPageInfo,
"total_count": 123
}
}
}
category
Deprecated
Use categories instead.
Search for categories that match the criteria specified in the search and filter attributes.
Response: CategoryTree
Arguments
id - IntExample
Query
query category($id: Int) {
category(id: $id) {
automatic_sorting
available_sort_by
breadcrumbs {
...BreadcrumbFragment
}
canonical_url
children {
...CategoryTreeFragment
}
children_count
cms_block {
...CmsBlockFragment
}
created_at
custom_layout_update_file
default_sort_by
description
display_mode
filter_price_range
id
image
include_in_menu
is_anchor
landing_page
level
meta_description
meta_keywords
meta_title
name
path
path_in_store
position
product_count
products {
...CategoryProductsFragment
}
redirect_code
relative_url
staged
type
uid
updated_at
url_key
url_path
url_suffix
}
}
Variables
{"id": 123}
Response
{
"data": {
"category": {
"automatic_sorting": "xyz789",
"available_sort_by": ["abc123"],
"breadcrumbs": [Breadcrumb],
"canonical_url": "xyz789",
"children": [CategoryTree],
"children_count": "xyz789",
"cms_block": CmsBlock,
"created_at": "xyz789",
"custom_layout_update_file": "abc123",
"default_sort_by": "abc123",
"description": "xyz789",
"display_mode": "xyz789",
"filter_price_range": 987.65,
"id": 123,
"image": "xyz789",
"include_in_menu": 987,
"is_anchor": 123,
"landing_page": 987,
"level": 123,
"meta_description": "xyz789",
"meta_keywords": "xyz789",
"meta_title": "xyz789",
"name": "abc123",
"path": "xyz789",
"path_in_store": "abc123",
"position": 123,
"product_count": 123,
"products": CategoryProducts,
"redirect_code": 987,
"relative_url": "abc123",
"staged": true,
"type": "CMS_PAGE",
"uid": "4",
"updated_at": "xyz789",
"url_key": "xyz789",
"url_path": "abc123",
"url_suffix": "abc123"
}
}
}
categoryList
Deprecated
Use categories instead.
Return an array of categories based on the specified filters.
Response: [CategoryTree]
Arguments
filters - CategoryFilterInputpageSize - Int20currentPage - Int1Example
Query
query categoryList(
$filters: CategoryFilterInput,
$pageSize: Int,
$currentPage: Int
) {
categoryList(
filters: $filters,
pageSize: $pageSize,
currentPage: $currentPage
) {
automatic_sorting
available_sort_by
breadcrumbs {
...BreadcrumbFragment
}
canonical_url
children {
...CategoryTreeFragment
}
children_count
cms_block {
...CmsBlockFragment
}
created_at
custom_layout_update_file
default_sort_by
description
display_mode
filter_price_range
id
image
include_in_menu
is_anchor
landing_page
level
meta_description
meta_keywords
meta_title
name
path
path_in_store
position
product_count
products {
...CategoryProductsFragment
}
redirect_code
relative_url
staged
type
uid
updated_at
url_key
url_path
url_suffix
}
}
Variables
{
"filters": CategoryFilterInput,
"pageSize": 20,
"currentPage": 1
}
Response
{
"data": {
"categoryList": [
{
"automatic_sorting": "abc123",
"available_sort_by": ["abc123"],
"breadcrumbs": [Breadcrumb],
"canonical_url": "abc123",
"children": [CategoryTree],
"children_count": "abc123",
"cms_block": CmsBlock,
"created_at": "abc123",
"custom_layout_update_file": "xyz789",
"default_sort_by": "abc123",
"description": "abc123",
"display_mode": "abc123",
"filter_price_range": 987.65,
"id": 123,
"image": "xyz789",
"include_in_menu": 987,
"is_anchor": 123,
"landing_page": 987,
"level": 987,
"meta_description": "xyz789",
"meta_keywords": "xyz789",
"meta_title": "abc123",
"name": "xyz789",
"path": "abc123",
"path_in_store": "xyz789",
"position": 987,
"product_count": 987,
"products": CategoryProducts,
"redirect_code": 123,
"relative_url": "xyz789",
"staged": true,
"type": "CMS_PAGE",
"uid": "4",
"updated_at": "abc123",
"url_key": "abc123",
"url_path": "xyz789",
"url_suffix": "abc123"
}
]
}
}
checkoutAgreements
Return Terms and Conditions configuration information.
Response: [CheckoutAgreement]
Example
Query
query checkoutAgreements {
checkoutAgreements {
agreement_id
checkbox_text
content
content_height
is_html
mode
name
}
}
Response
{
"data": {
"checkoutAgreements": [
{
"agreement_id": 987,
"checkbox_text": "abc123",
"content": "xyz789",
"content_height": "xyz789",
"is_html": false,
"mode": "AUTO",
"name": "abc123"
}
]
}
}
cmsBlocks
Return information about CMS blocks.
Response: CmsBlocks
Arguments
identifiers - [String]Example
Query
query cmsBlocks($identifiers: [String]) {
cmsBlocks(identifiers: $identifiers) {
items {
...CmsBlockFragment
}
}
}
Variables
{"identifiers": ["abc123"]}
Response
{"data": {"cmsBlocks": {"items": [CmsBlock]}}}
cmsPage
Return details about a CMS page.
Response: CmsPage
Arguments
id - Intidentifier - StringExample
Query
query cmsPage(
$id: Int,
$identifier: String
) {
cmsPage(
id: $id,
identifier: $identifier
) {
content
content_heading
identifier
meta_description
meta_keywords
meta_title
page_layout
redirect_code
relative_url
title
type
url_key
}
}
Variables
{"id": 987, "identifier": "abc123"}
Response
{
"data": {
"cmsPage": {
"content": "abc123",
"content_heading": "xyz789",
"identifier": "abc123",
"meta_description": "abc123",
"meta_keywords": "abc123",
"meta_title": "abc123",
"page_layout": "xyz789",
"redirect_code": 123,
"relative_url": "abc123",
"title": "abc123",
"type": "CMS_PAGE",
"url_key": "abc123"
}
}
}
company
Return detailed information about the authenticated customer's company.
Response: Company
Example
Query
query company {
company {
acl_resources {
...CompanyAclResourceFragment
}
company_admin {
...CustomerFragment
}
credit {
...CompanyCreditFragment
}
credit_history {
...CompanyCreditHistoryFragment
}
email
id
legal_address {
...CompanyLegalAddressFragment
}
legal_name
name
payment_methods
reseller_id
role {
...CompanyRoleFragment
}
roles {
...CompanyRolesFragment
}
sales_representative {
...CompanySalesRepresentativeFragment
}
structure {
...CompanyStructureFragment
}
team {
...CompanyTeamFragment
}
user {
...CustomerFragment
}
users {
...CompanyUsersFragment
}
vat_tax_id
}
}
Response
{
"data": {
"company": {
"acl_resources": [CompanyAclResource],
"company_admin": Customer,
"credit": CompanyCredit,
"credit_history": CompanyCreditHistory,
"email": "xyz789",
"id": "4",
"legal_address": CompanyLegalAddress,
"legal_name": "xyz789",
"name": "xyz789",
"payment_methods": ["xyz789"],
"reseller_id": "abc123",
"role": CompanyRole,
"roles": CompanyRoles,
"sales_representative": CompanySalesRepresentative,
"structure": CompanyStructure,
"team": CompanyTeam,
"user": Customer,
"users": CompanyUsers,
"vat_tax_id": "xyz789"
}
}
}
compareList
Return products that have been added to the specified compare list.
Response: CompareList
Arguments
uid - ID!Example
Query
query compareList($uid: ID!) {
compareList(uid: $uid) {
attributes {
...ComparableAttributeFragment
}
item_count
items {
...ComparableItemFragment
}
uid
}
}
Variables
{"uid": "4"}
Response
{
"data": {
"compareList": {
"attributes": [ComparableAttribute],
"item_count": 987,
"items": [ComparableItem],
"uid": "4"
}
}
}
countries
The countries query provides information for all countries.
Response: [Country]
Example
Query
query countries {
countries {
available_regions {
...RegionFragment
}
full_name_english
full_name_locale
id
three_letter_abbreviation
two_letter_abbreviation
}
}
Response
{
"data": {
"countries": [
{
"available_regions": [Region],
"full_name_english": "abc123",
"full_name_locale": "abc123",
"id": "xyz789",
"three_letter_abbreviation": "abc123",
"two_letter_abbreviation": "xyz789"
}
]
}
}
country
The countries query provides information for a single country.
Response: Country
Arguments
id - StringExample
Query
query country($id: String) {
country(id: $id) {
available_regions {
...RegionFragment
}
full_name_english
full_name_locale
id
three_letter_abbreviation
two_letter_abbreviation
}
}
Variables
{"id": "abc123"}
Response
{
"data": {
"country": {
"available_regions": [Region],
"full_name_english": "xyz789",
"full_name_locale": "abc123",
"id": "abc123",
"three_letter_abbreviation": "abc123",
"two_letter_abbreviation": "abc123"
}
}
}
currency
Return information about the store's currency.
Response: Currency
Example
Query
query currency {
currency {
available_currency_codes
base_currency_code
base_currency_symbol
default_display_currecy_code
default_display_currecy_symbol
default_display_currency_code
default_display_currency_symbol
exchange_rates {
...ExchangeRateFragment
}
}
}
Response
{
"data": {
"currency": {
"available_currency_codes": [
"xyz789"
],
"base_currency_code": "abc123",
"base_currency_symbol": "xyz789",
"default_display_currecy_code": "abc123",
"default_display_currecy_symbol": "abc123",
"default_display_currency_code": "xyz789",
"default_display_currency_symbol": "xyz789",
"exchange_rates": [ExchangeRate]
}
}
}
customAttributeMetadata
Return the attribute type, given an attribute code and entity type.
Response: CustomAttributeMetadata
Arguments
attributes - [AttributeInput!]!Example
Query
query customAttributeMetadata($attributes: [AttributeInput!]!) {
customAttributeMetadata(attributes: $attributes) {
items {
...AttributeFragment
}
}
}
Variables
{"attributes": [AttributeInput]}
Response
{
"data": {
"customAttributeMetadata": {"items": [Attribute]}
}
}
customer
Return detailed information about a customer account.
Response: Customer
Example
Query
query customer {
customer {
addresses {
...CustomerAddressFragment
}
allow_remote_shopping_assistance
compare_list {
...CompareListFragment
}
created_at
date_of_birth
default_billing
default_shipping
dob
email
firstname
gender
gift_registries {
...GiftRegistryFragment
}
gift_registry {
...GiftRegistryFragment
}
group_id
id
is_subscribed
job_title
lastname
middlename
orders {
...CustomerOrdersFragment
}
prefix
purchase_order {
...PurchaseOrderFragment
}
purchase_order_approval_rule {
...PurchaseOrderApprovalRuleFragment
}
purchase_order_approval_rule_metadata {
...PurchaseOrderApprovalRuleMetadataFragment
}
purchase_order_approval_rules {
...PurchaseOrderApprovalRulesFragment
}
purchase_orders {
...PurchaseOrdersFragment
}
purchase_orders_enabled
requisition_lists {
...RequisitionListsFragment
}
return {
...ReturnFragment
}
returns {
...ReturnsFragment
}
reviews {
...ProductReviewsFragment
}
reward_points {
...RewardPointsFragment
}
role {
...CompanyRoleFragment
}
status
store_credit {
...CustomerStoreCreditFragment
}
structure_id
suffix
taxvat
team {
...CompanyTeamFragment
}
telephone
wishlist {
...WishlistFragment
}
wishlist_v2 {
...WishlistFragment
}
wishlists {
...WishlistFragment
}
}
}
Response
{
"data": {
"customer": {
"addresses": [CustomerAddress],
"allow_remote_shopping_assistance": true,
"compare_list": CompareList,
"created_at": "abc123",
"date_of_birth": "abc123",
"default_billing": "abc123",
"default_shipping": "abc123",
"dob": "xyz789",
"email": "abc123",
"firstname": "xyz789",
"gender": 123,
"gift_registries": [GiftRegistry],
"gift_registry": GiftRegistry,
"group_id": 987,
"id": 123,
"is_subscribed": false,
"job_title": "abc123",
"lastname": "xyz789",
"middlename": "xyz789",
"orders": CustomerOrders,
"prefix": "abc123",
"purchase_order": PurchaseOrder,
"purchase_order_approval_rule": PurchaseOrderApprovalRule,
"purchase_order_approval_rule_metadata": PurchaseOrderApprovalRuleMetadata,
"purchase_order_approval_rules": PurchaseOrderApprovalRules,
"purchase_orders": PurchaseOrders,
"purchase_orders_enabled": true,
"requisition_lists": RequisitionLists,
"return": Return,
"returns": Returns,
"reviews": ProductReviews,
"reward_points": RewardPoints,
"role": CompanyRole,
"status": "ACTIVE",
"store_credit": CustomerStoreCredit,
"structure_id": "4",
"suffix": "abc123",
"taxvat": "abc123",
"team": CompanyTeam,
"telephone": "xyz789",
"wishlist": Wishlist,
"wishlist_v2": Wishlist,
"wishlists": [Wishlist]
}
}
}
customerCart
Return information about the customer's shopping cart.
Response: Cart!
Example
Query
query customerCart {
customerCart {
applied_coupon {
...AppliedCouponFragment
}
applied_coupons {
...AppliedCouponFragment
}
applied_gift_cards {
...AppliedGiftCardFragment
}
applied_reward_points {
...RewardPointsAmountFragment
}
applied_store_credit {
...AppliedStoreCreditFragment
}
available_gift_wrappings {
...GiftWrappingFragment
}
available_payment_methods {
...AvailablePaymentMethodFragment
}
billing_address {
...BillingCartAddressFragment
}
email
gift_message {
...GiftMessageFragment
}
gift_receipt_included
gift_wrapping {
...GiftWrappingFragment
}
id
is_virtual
items {
...CartItemInterfaceFragment
}
prices {
...CartPricesFragment
}
printed_card_included
selected_payment_method {
...SelectedPaymentMethodFragment
}
shipping_addresses {
...ShippingCartAddressFragment
}
total_quantity
}
}
Response
{
"data": {
"customerCart": {
"applied_coupon": AppliedCoupon,
"applied_coupons": [AppliedCoupon],
"applied_gift_cards": [AppliedGiftCard],
"applied_reward_points": RewardPointsAmount,
"applied_store_credit": AppliedStoreCredit,
"available_gift_wrappings": [GiftWrapping],
"available_payment_methods": [
AvailablePaymentMethod
],
"billing_address": BillingCartAddress,
"email": "abc123",
"gift_message": GiftMessage,
"gift_receipt_included": true,
"gift_wrapping": GiftWrapping,
"id": 4,
"is_virtual": false,
"items": [CartItemInterface],
"prices": CartPrices,
"printed_card_included": true,
"selected_payment_method": SelectedPaymentMethod,
"shipping_addresses": [ShippingCartAddress],
"total_quantity": 987.65
}
}
}
customerDownloadableProducts
Return a list of downloadable products the customer has purchased.
Response: CustomerDownloadableProducts
Example
Query
query customerDownloadableProducts {
customerDownloadableProducts {
items {
...CustomerDownloadableProductFragment
}
}
}
Response
{
"data": {
"customerDownloadableProducts": {
"items": [CustomerDownloadableProduct]
}
}
}
customerOrders
Deprecated
Use the customer query instead.
Response: CustomerOrders
Example
Query
query customerOrders {
customerOrders {
items {
...CustomerOrderFragment
}
page_info {
...SearchResultPageInfoFragment
}
total_count
}
}
Response
{
"data": {
"customerOrders": {
"items": [CustomerOrder],
"page_info": SearchResultPageInfo,
"total_count": 987
}
}
}
customerPaymentTokens
Return a list of customer payment tokens stored in the vault.
Response: CustomerPaymentTokens
Example
Query
query customerPaymentTokens {
customerPaymentTokens {
items {
...PaymentTokenFragment
}
}
}
Response
{
"data": {
"customerPaymentTokens": {"items": [PaymentToken]}
}
}
dynamicBlocks
Return a list of dynamic blocks filtered by type, location, or UIDs.
Response: DynamicBlocks!
Arguments
input - DynamicBlocksFilterInputpageSize - Int20currentPage - Int1Example
Query
query dynamicBlocks(
$input: DynamicBlocksFilterInput,
$pageSize: Int,
$currentPage: Int
) {
dynamicBlocks(
input: $input,
pageSize: $pageSize,
currentPage: $currentPage
) {
items {
...DynamicBlockFragment
}
page_info {
...SearchResultPageInfoFragment
}
total_count
}
}
Variables
{
"input": DynamicBlocksFilterInput,
"pageSize": 20,
"currentPage": 1
}
Response
{
"data": {
"dynamicBlocks": {
"items": [DynamicBlock],
"page_info": SearchResultPageInfo,
"total_count": 123
}
}
}
getHostedProUrl
Retrieve the secure PayPal URL for a Payments Pro Hosted Solution transaction.
Response: HostedProUrl
Arguments
input - HostedProUrlInput!Example
Query
query getHostedProUrl($input: HostedProUrlInput!) {
getHostedProUrl(input: $input) {
secure_form_url
}
}
Variables
{"input": HostedProUrlInput}
Response
{
"data": {
"getHostedProUrl": {
"secure_form_url": "xyz789"
}
}
}
getPayflowLinkToken
Retrieve payment credentials for a transaction. Use this query for Payflow Link and Payments Advanced payment methods.
Response: PayflowLinkToken
Arguments
input - PayflowLinkTokenInput!Example
Query
query getPayflowLinkToken($input: PayflowLinkTokenInput!) {
getPayflowLinkToken(input: $input) {
mode
paypal_url
secure_token
secure_token_id
}
}
Variables
{"input": PayflowLinkTokenInput}
Response
{
"data": {
"getPayflowLinkToken": {
"mode": "TEST",
"paypal_url": "xyz789",
"secure_token": "abc123",
"secure_token_id": "xyz789"
}
}
}
giftCardAccount
Return details about a specific gift card.
Response: GiftCardAccount
Arguments
input - GiftCardAccountInput!Example
Query
query giftCardAccount($input: GiftCardAccountInput!) {
giftCardAccount(input: $input) {
balance {
...MoneyFragment
}
code
expiration_date
}
}
Variables
{"input": GiftCardAccountInput}
Response
{
"data": {
"giftCardAccount": {
"balance": Money,
"code": "xyz789",
"expiration_date": "xyz789"
}
}
}
giftRegistry
Return the specified gift registry. Some details will not be available to guests.
Response: GiftRegistry
Arguments
giftRegistryUid - ID!Example
Query
query giftRegistry($giftRegistryUid: ID!) {
giftRegistry(giftRegistryUid: $giftRegistryUid) {
created_at
dynamic_attributes {
...GiftRegistryDynamicAttributeFragment
}
event_name
items {
...GiftRegistryItemInterfaceFragment
}
message
owner_name
privacy_settings
registrants {
...GiftRegistryRegistrantFragment
}
shipping_address {
...CustomerAddressFragment
}
status
type {
...GiftRegistryTypeFragment
}
uid
}
}
Variables
{"giftRegistryUid": 4}
Response
{
"data": {
"giftRegistry": {
"created_at": "abc123",
"dynamic_attributes": [
GiftRegistryDynamicAttribute
],
"event_name": "abc123",
"items": [GiftRegistryItemInterface],
"message": "xyz789",
"owner_name": "xyz789",
"privacy_settings": "PRIVATE",
"registrants": [GiftRegistryRegistrant],
"shipping_address": CustomerAddress,
"status": "ACTIVE",
"type": GiftRegistryType,
"uid": "4"
}
}
}
giftRegistryEmailSearch
Search for gift registries by specifying a registrant email address.
Response: [GiftRegistrySearchResult]
Arguments
email - String!Example
Query
query giftRegistryEmailSearch($email: String!) {
giftRegistryEmailSearch(email: $email) {
event_date
event_title
gift_registry_uid
location
name
type
}
}
Variables
{"email": "abc123"}
Response
{
"data": {
"giftRegistryEmailSearch": [
{
"event_date": "abc123",
"event_title": "xyz789",
"gift_registry_uid": "4",
"location": "abc123",
"name": "xyz789",
"type": "abc123"
}
]
}
}
giftRegistryIdSearch
Search for gift registries by specifying a registry URL key.
Response: [GiftRegistrySearchResult]
Arguments
giftRegistryUid - ID!Example
Query
query giftRegistryIdSearch($giftRegistryUid: ID!) {
giftRegistryIdSearch(giftRegistryUid: $giftRegistryUid) {
event_date
event_title
gift_registry_uid
location
name
type
}
}
Variables
{"giftRegistryUid": 4}
Response
{
"data": {
"giftRegistryIdSearch": [
{
"event_date": "abc123",
"event_title": "xyz789",
"gift_registry_uid": "4",
"location": "xyz789",
"name": "xyz789",
"type": "abc123"
}
]
}
}
giftRegistryTypeSearch
Search for gift registries by specifying the registrant name and registry type ID.
Response: [GiftRegistrySearchResult]
Arguments
firstName - String!lastName - String!giftRegistryTypeUid - IDExample
Query
query giftRegistryTypeSearch(
$firstName: String!,
$lastName: String!,
$giftRegistryTypeUid: ID
) {
giftRegistryTypeSearch(
firstName: $firstName,
lastName: $lastName,
giftRegistryTypeUid: $giftRegistryTypeUid
) {
event_date
event_title
gift_registry_uid
location
name
type
}
}
Variables
{
"firstName": "xyz789",
"lastName": "abc123",
"giftRegistryTypeUid": 4
}
Response
{
"data": {
"giftRegistryTypeSearch": [
{
"event_date": "xyz789",
"event_title": "xyz789",
"gift_registry_uid": 4,
"location": "abc123",
"name": "xyz789",
"type": "abc123"
}
]
}
}
giftRegistryTypes
Get a list of available gift registry types.
Response: [GiftRegistryType]
Example
Query
query giftRegistryTypes {
giftRegistryTypes {
dynamic_attributes_metadata {
...GiftRegistryDynamicAttributeMetadataInterfaceFragment
}
label
uid
}
}
Response
{
"data": {
"giftRegistryTypes": [
{
"dynamic_attributes_metadata": [
GiftRegistryDynamicAttributeMetadataInterface
],
"label": "abc123",
"uid": "4"
}
]
}
}
isCompanyAdminEmailAvailable
Check whether the specified email can be used to register a company admin.
Response: IsCompanyAdminEmailAvailableOutput
Arguments
email - String!Example
Query
query isCompanyAdminEmailAvailable($email: String!) {
isCompanyAdminEmailAvailable(email: $email) {
is_email_available
}
}
Variables
{"email": "abc123"}
Response
{"data": {"isCompanyAdminEmailAvailable": {"is_email_available": true}}}
isCompanyEmailAvailable
Check whether the specified email can be used to register a new company.
Response: IsCompanyEmailAvailableOutput
Arguments
email - String!Example
Query
query isCompanyEmailAvailable($email: String!) {
isCompanyEmailAvailable(email: $email) {
is_email_available
}
}
Variables
{"email": "xyz789"}
Response
{"data": {"isCompanyEmailAvailable": {"is_email_available": true}}}
isCompanyRoleNameAvailable
Check whether the specified role name is valid for the company.
Response: IsCompanyRoleNameAvailableOutput
Arguments
name - String!Example
Query
query isCompanyRoleNameAvailable($name: String!) {
isCompanyRoleNameAvailable(name: $name) {
is_role_name_available
}
}
Variables
{"name": "abc123"}
Response
{"data": {"isCompanyRoleNameAvailable": {"is_role_name_available": true}}}
isCompanyUserEmailAvailable
Check whether the specified email can be used to register a company user.
Response: IsCompanyUserEmailAvailableOutput
Arguments
email - String!Example
Query
query isCompanyUserEmailAvailable($email: String!) {
isCompanyUserEmailAvailable(email: $email) {
is_email_available
}
}
Variables
{"email": "abc123"}
Response
{"data": {"isCompanyUserEmailAvailable": {"is_email_available": true}}}
isEmailAvailable
Check whether the specified email has already been used to create a customer account.
Response: IsEmailAvailableOutput
Arguments
email - String!Example
Query
query isEmailAvailable($email: String!) {
isEmailAvailable(email: $email) {
is_email_available
}
}
Variables
{"email": "abc123"}
Response
{"data": {"isEmailAvailable": {"is_email_available": true}}}
negotiableQuote
Retrieve the specified negotiable quote.
Response: NegotiableQuote
Arguments
uid - ID!Example
Query
query negotiableQuote($uid: ID!) {
negotiableQuote(uid: $uid) {
available_payment_methods {
...AvailablePaymentMethodFragment
}
billing_address {
...NegotiableQuoteBillingAddressFragment
}
buyer {
...NegotiableQuoteUserFragment
}
comments {
...NegotiableQuoteCommentFragment
}
created_at
email
history {
...NegotiableQuoteHistoryEntryFragment
}
is_virtual
items {
...CartItemInterfaceFragment
}
name
prices {
...CartPricesFragment
}
selected_payment_method {
...SelectedPaymentMethodFragment
}
shipping_addresses {
...NegotiableQuoteShippingAddressFragment
}
status
total_quantity
uid
updated_at
}
}
Variables
{"uid": "4"}
Response
{
"data": {
"negotiableQuote": {
"available_payment_methods": [
AvailablePaymentMethod
],
"billing_address": NegotiableQuoteBillingAddress,
"buyer": NegotiableQuoteUser,
"comments": [NegotiableQuoteComment],
"created_at": "abc123",
"email": "abc123",
"history": [NegotiableQuoteHistoryEntry],
"is_virtual": true,
"items": [CartItemInterface],
"name": "abc123",
"prices": CartPrices,
"selected_payment_method": SelectedPaymentMethod,
"shipping_addresses": [
NegotiableQuoteShippingAddress
],
"status": "SUBMITTED",
"total_quantity": 987.65,
"uid": "4",
"updated_at": "abc123"
}
}
}
negotiableQuotes
Return a list of negotiable quotes that can be viewed by the logged-in customer.
Response: NegotiableQuotesOutput
Arguments
filter - NegotiableQuoteFilterInputpageSize - Int20currentPage - Int1sort - NegotiableQuoteSortInputExample
Query
query negotiableQuotes(
$filter: NegotiableQuoteFilterInput,
$pageSize: Int,
$currentPage: Int,
$sort: NegotiableQuoteSortInput
) {
negotiableQuotes(
filter: $filter,
pageSize: $pageSize,
currentPage: $currentPage,
sort: $sort
) {
items {
...NegotiableQuoteFragment
}
page_info {
...SearchResultPageInfoFragment
}
sort_fields {
...SortFieldsFragment
}
total_count
}
}
Variables
{
"filter": NegotiableQuoteFilterInput,
"pageSize": 20,
"currentPage": 1,
"sort": NegotiableQuoteSortInput
}
Response
{
"data": {
"negotiableQuotes": {
"items": [NegotiableQuote],
"page_info": SearchResultPageInfo,
"sort_fields": SortFields,
"total_count": 987
}
}
}
pickupLocations
The pickup locations query searches for locations that match the search request requirements.
Response: PickupLocations
Arguments
area - AreaInputfilters - PickupLocationFilterInputsort - PickupLocationSortInputpageSize - Int20currentPage - Int1productsInfo - [ProductInfoInput]Example
Query
query pickupLocations(
$area: AreaInput,
$filters: PickupLocationFilterInput,
$sort: PickupLocationSortInput,
$pageSize: Int,
$currentPage: Int,
$productsInfo: [ProductInfoInput]
) {
pickupLocations(
area: $area,
filters: $filters,
sort: $sort,
pageSize: $pageSize,
currentPage: $currentPage,
productsInfo: $productsInfo
) {
items {
...PickupLocationFragment
}
page_info {
...SearchResultPageInfoFragment
}
total_count
}
}
Variables
{
"area": AreaInput,
"filters": PickupLocationFilterInput,
"sort": PickupLocationSortInput,
"pageSize": 20,
"currentPage": 1,
"productsInfo": [ProductInfoInput]
}
Response
{
"data": {
"pickupLocations": {
"items": [PickupLocation],
"page_info": SearchResultPageInfo,
"total_count": 123
}
}
}
productReviewRatingsMetadata
Return the active ratings attributes and the values each rating can have.
Response: ProductReviewRatingsMetadata!
Example
Query
query productReviewRatingsMetadata {
productReviewRatingsMetadata {
items {
...ProductReviewRatingMetadataFragment
}
}
}
Response
{
"data": {
"productReviewRatingsMetadata": {
"items": [ProductReviewRatingMetadata]
}
}
}
products
Search for products that match the criteria specified in the search and filter attributes.
Response: Products
Arguments
search - Stringfilter - ProductAttributeFilterInputpageSize - Int20currentPage - Int1sort - ProductAttributeSortInputExample
Query
query products(
$search: String,
$filter: ProductAttributeFilterInput,
$pageSize: Int,
$currentPage: Int,
$sort: ProductAttributeSortInput
) {
products(
search: $search,
filter: $filter,
pageSize: $pageSize,
currentPage: $currentPage,
sort: $sort
) {
aggregations {
...AggregationFragment
}
filters {
...LayerFilterFragment
}
items {
...ProductInterfaceFragment
}
page_info {
...SearchResultPageInfoFragment
}
sort_fields {
...SortFieldsFragment
}
suggestions {
...SearchSuggestionFragment
}
total_count
}
}
Variables
{
"search": "abc123",
"filter": ProductAttributeFilterInput,
"pageSize": 20,
"currentPage": 1,
"sort": ProductAttributeSortInput
}
Response
{
"data": {
"products": {
"aggregations": [Aggregation],
"filters": [LayerFilter],
"items": [ProductInterface],
"page_info": SearchResultPageInfo,
"sort_fields": SortFields,
"suggestions": [SearchSuggestion],
"total_count": 987
}
}
}
route
Return the full details for a specified product, category, or CMS page.
Response: RoutableInterface
Arguments
url - String!Example
Query
query route($url: String!) {
route(url: $url) {
redirect_code
relative_url
type
}
}
Variables
{"url": "abc123"}
Response
{
"data": {
"route": {
"redirect_code": 987,
"relative_url": "xyz789",
"type": "CMS_PAGE"
}
}
}
storeConfig
Return details about the store's configuration.
Response: StoreConfig
Example
Query
query storeConfig {
storeConfig {
absolute_footer
allow_gift_receipt
allow_gift_wrapping_on_order
allow_gift_wrapping_on_order_items
allow_guests_to_write_product_reviews
allow_items
allow_order
allow_printed_card
autocomplete_on_storefront
base_currency_code
base_link_url
base_media_url
base_static_url
base_url
braintree_cc_vault_active
cart_gift_wrapping
cart_printed_card
catalog_default_sort_by
category_fixed_product_tax_display_setting
category_url_suffix
check_money_order_enable_for_specific_countries
check_money_order_enabled
check_money_order_make_check_payable_to
check_money_order_max_order_total
check_money_order_min_order_total
check_money_order_new_order_status
check_money_order_payment_from_specific_countries
check_money_order_send_check_to
check_money_order_sort_order
check_money_order_title
cms_home_page
cms_no_cookies
cms_no_route
code
configurable_thumbnail_source
copyright
default_description
default_display_currency_code
default_keywords
default_title
demonotice
enable_multiple_wishlists
front
grid_per_page
grid_per_page_values
head_includes
head_shortcut_icon
header_logo_src
id
is_default_store
is_default_store_group
is_negotiable_quote_active
is_requisition_list_active
list_mode
list_per_page
list_per_page_values
locale
logo_alt
logo_height
logo_width
magento_reward_general_is_enabled
magento_reward_general_is_enabled_on_front
magento_reward_general_min_points_balance
magento_reward_general_publish_history
magento_reward_points_invitation_customer
magento_reward_points_invitation_customer_limit
magento_reward_points_invitation_order
magento_reward_points_invitation_order_limit
magento_reward_points_newsletter
magento_reward_points_order
magento_reward_points_register
magento_reward_points_review
magento_reward_points_review_limit
magento_wishlist_general_is_enabled
maximum_number_of_wishlists
minimum_password_length
no_route
payment_payflowpro_cc_vault_active
printed_card_price
product_fixed_product_tax_display_setting
product_reviews_enabled
product_url_suffix
required_character_classes_number
returns_enabled
root_category_id
root_category_uid
sales_fixed_product_tax_display_setting
sales_gift_wrapping
sales_printed_card
secure_base_link_url
secure_base_media_url
secure_base_static_url
secure_base_url
send_friend {
...SendFriendConfigurationFragment
}
show_cms_breadcrumbs
store_code
store_group_code
store_group_name
store_name
store_sort_order
timezone
title_prefix
title_separator
title_suffix
use_store_in_url
website_code
website_id
website_name
weight_unit
welcome
zero_subtotal_enable_for_specific_countries
zero_subtotal_enabled
zero_subtotal_new_order_status
zero_subtotal_payment_action
zero_subtotal_payment_from_specific_countries
zero_subtotal_sort_order
zero_subtotal_title
}
}
Response
{
"data": {
"storeConfig": {
"absolute_footer": "xyz789",
"allow_gift_receipt": "xyz789",
"allow_gift_wrapping_on_order": "abc123",
"allow_gift_wrapping_on_order_items": "abc123",
"allow_guests_to_write_product_reviews": "abc123",
"allow_items": "xyz789",
"allow_order": "abc123",
"allow_printed_card": "xyz789",
"autocomplete_on_storefront": false,
"base_currency_code": "xyz789",
"base_link_url": "xyz789",
"base_media_url": "xyz789",
"base_static_url": "xyz789",
"base_url": "abc123",
"braintree_cc_vault_active": "abc123",
"cart_gift_wrapping": "xyz789",
"cart_printed_card": "abc123",
"catalog_default_sort_by": "xyz789",
"category_fixed_product_tax_display_setting": "INCLUDE_FPT_WITHOUT_DETAILS",
"category_url_suffix": "abc123",
"check_money_order_enable_for_specific_countries": false,
"check_money_order_enabled": false,
"check_money_order_make_check_payable_to": "xyz789",
"check_money_order_max_order_total": "xyz789",
"check_money_order_min_order_total": "xyz789",
"check_money_order_new_order_status": "abc123",
"check_money_order_payment_from_specific_countries": "xyz789",
"check_money_order_send_check_to": "abc123",
"check_money_order_sort_order": 123,
"check_money_order_title": "abc123",
"cms_home_page": "xyz789",
"cms_no_cookies": "abc123",
"cms_no_route": "abc123",
"code": "xyz789",
"configurable_thumbnail_source": "xyz789",
"copyright": "abc123",
"default_description": "xyz789",
"default_display_currency_code": "xyz789",
"default_keywords": "abc123",
"default_title": "xyz789",
"demonotice": 987,
"enable_multiple_wishlists": "xyz789",
"front": "xyz789",
"grid_per_page": 987,
"grid_per_page_values": "abc123",
"head_includes": "abc123",
"head_shortcut_icon": "xyz789",
"header_logo_src": "abc123",
"id": 123,
"is_default_store": false,
"is_default_store_group": false,
"is_negotiable_quote_active": false,
"is_requisition_list_active": "abc123",
"list_mode": "abc123",
"list_per_page": 123,
"list_per_page_values": "xyz789",
"locale": "xyz789",
"logo_alt": "abc123",
"logo_height": 123,
"logo_width": 987,
"magento_reward_general_is_enabled": "xyz789",
"magento_reward_general_is_enabled_on_front": "xyz789",
"magento_reward_general_min_points_balance": "abc123",
"magento_reward_general_publish_history": "abc123",
"magento_reward_points_invitation_customer": "abc123",
"magento_reward_points_invitation_customer_limit": "abc123",
"magento_reward_points_invitation_order": "abc123",
"magento_reward_points_invitation_order_limit": "abc123",
"magento_reward_points_newsletter": "abc123",
"magento_reward_points_order": "abc123",
"magento_reward_points_register": "xyz789",
"magento_reward_points_review": "abc123",
"magento_reward_points_review_limit": "abc123",
"magento_wishlist_general_is_enabled": "abc123",
"maximum_number_of_wishlists": "abc123",
"minimum_password_length": "xyz789",
"no_route": "xyz789",
"payment_payflowpro_cc_vault_active": "xyz789",
"printed_card_price": "xyz789",
"product_fixed_product_tax_display_setting": "INCLUDE_FPT_WITHOUT_DETAILS",
"product_reviews_enabled": "abc123",
"product_url_suffix": "xyz789",
"required_character_classes_number": "xyz789",
"returns_enabled": "xyz789",
"root_category_id": 123,
"root_category_uid": "4",
"sales_fixed_product_tax_display_setting": "INCLUDE_FPT_WITHOUT_DETAILS",
"sales_gift_wrapping": "xyz789",
"sales_printed_card": "abc123",
"secure_base_link_url": "xyz789",
"secure_base_media_url": "xyz789",
"secure_base_static_url": "abc123",
"secure_base_url": "xyz789",
"send_friend": SendFriendConfiguration,
"show_cms_breadcrumbs": 123,
"store_code": "4",
"store_group_code": "4",
"store_group_name": "xyz789",
"store_name": "xyz789",
"store_sort_order": 987,
"timezone": "xyz789",
"title_prefix": "xyz789",
"title_separator": "abc123",
"title_suffix": "xyz789",
"use_store_in_url": false,
"website_code": "4",
"website_id": 987,
"website_name": "abc123",
"weight_unit": "xyz789",
"welcome": "xyz789",
"zero_subtotal_enable_for_specific_countries": true,
"zero_subtotal_enabled": true,
"zero_subtotal_new_order_status": "xyz789",
"zero_subtotal_payment_action": "abc123",
"zero_subtotal_payment_from_specific_countries": "xyz789",
"zero_subtotal_sort_order": 123,
"zero_subtotal_title": "abc123"
}
}
}
urlResolver
Deprecated
Use the route query instead.
Return the relative URL for a specified product, category or CMS page.
Response: EntityUrl
Arguments
url - String!Example
Query
query urlResolver($url: String!) {
urlResolver(url: $url) {
canonical_url
entity_uid
id
redirectCode
relative_url
type
}
}
Variables
{"url": "abc123"}
Response
{
"data": {
"urlResolver": {
"canonical_url": "xyz789",
"entity_uid": "4",
"id": 987,
"redirectCode": 123,
"relative_url": "xyz789",
"type": "CMS_PAGE"
}
}
}
wishlist
Deprecated
Moved under Customer.wishlist.
Return the contents of a customer's wish list.
Response: WishlistOutput
Example
Query
query wishlist {
wishlist {
items {
...WishlistItemFragment
}
items_count
name
sharing_code
updated_at
}
}
Response
{
"data": {
"wishlist": {
"items": [WishlistItem],
"items_count": 987,
"name": "xyz789",
"sharing_code": "xyz789",
"updated_at": "abc123"
}
}
}