Query Root
The schema's entry-point for queries. This acts as the public, top-level API from which all queries must start.
Anchor to Fields and connectionsFields and connections
- Anchor to abandonedCheckoutsabandoned•
Checkouts AbandonedCheckout Connection!non-null List of abandoned checkouts. Includes checkouts that were recovered after being abandoned.
- Anchor to abandonedCheckoutsCountabandoned•
Checkouts Count Returns the count of abandoned checkouts for the given shop. Limited to a maximum of 10000.
- Anchor to abandonmentabandonment•
Returns an abandonment by ID.
- Anchor to abandonmentByAbandonedCheckoutIdabandonment•
By Abandoned Checkout Id Returns an Abandonment by the Abandoned Checkout ID.
- •
Lookup an App by ID or return the currently authenticated App.
- Anchor to appByHandleapp•
By Handle Fetches app by handle. Returns null if the app doesn't exist.
- Anchor to appByKeyapp•
By Key Fetches an app by its client ID. Returns null if the app doesn't exist.
- Anchor to appCreditsapp•
Credits AppCredit Connection!non-null Credits that can be used towards future app purchases.
- Anchor to appDiscountTypeapp•
Discount Type An app discount type.
- Anchor to appDiscountTypesapp•
Discount Types [AppDiscount Type!]!non-null A list of app discount types installed by apps.
- Anchor to appDiscountTypesNodesapp•
Discount Types Nodes AppDiscount Type Connection!non-null A list of app discount types installed by apps.
- Anchor to appInstallationapp•
Installation Lookup an AppInstallation by ID or return the AppInstallation for the currently authenticated App.
- Anchor to appInstallationsapp•
Installations AppInstallation Connection!non-null A list of app installations. To use this query, you need to contact Shopify Support to grant your custom app the
access scope. Public apps can't be granted this access scope.
- Anchor to articlearticle•
Returns an Article resource by ID.
- Anchor to articleAuthorsarticle•
Authors ArticleAuthor Connection!non-null List of article authors for the shop.
- Anchor to articlesarticles•Article
Connection!non-null List of the shop's articles.
- Anchor to articleTagsarticle•
Tags [String!]!non-null List of all article tags.
- Anchor to assignedFulfillmentOrdersassigned•
Fulfillment Orders FulfillmentOrder Connection!non-null The paginated list of fulfillment orders assigned to the shop locations owned by the app.
Assigned fulfillment orders are fulfillment orders that are set to be fulfilled from locations managed by fulfillment services that are registered by the app. One app (api_client) can host multiple fulfillment services on a shop. Each fulfillment service manages a dedicated location on a shop. Assigned fulfillment orders can have associated fulfillment requests, or might currently not be requested to be fulfilled.
The app must have the
access scope to be able to retrieve the fulfillment orders assigned to its locations.
All assigned fulfillment orders (except those with the
status) will be returned by default. Perform filtering with the
argument to receive only fulfillment orders that have been requested to be fulfilled.
- Anchor to automaticDiscountNodeautomatic•
Discount Node Returns an automatic discount resource by ID.
- Anchor to automaticDiscountNodesautomatic•
Discount Nodes DiscountAutomatic Node Connection!non-null Returns a list of automatic discounts.
- Anchor to automaticDiscountSavedSearchesautomatic•
Discount Saved Searches SavedSearch Connection!non-null List of the shop's automatic discount saved searches.
- Anchor to availableBackupRegionsavailable•
Backup Regions [MarketRegion!]!non-null The regions that can be used as the backup region of the shop.
- Anchor to availableCarrierServicesavailable•
Carrier Services Returns a list of activated carrier services and associated shop locations that support them.
- Anchor to availableLocalesavailable•
Locales [Locale!]!non-null A list of available locales.
- Anchor to backupRegionbackup•
Region MarketRegion!non-null The backup region of the shop.
- Anchor to balanceAccountbalance•
Account Returns the Balance account information for finance embedded apps.
- Anchor to blogblog•
Returns a Blog resource by ID.
- Anchor to blogsblogs•Blog
Connection!non-null List of the shop's blogs.
- Anchor to blogsCountblogs•
Count Count of blogs.
- Anchor to bundleCountbundle•
Count Int!non-null Returns the number of bundle products that have been created by the current app.
- Anchor to businessEntitiesbusiness•
Entities [BusinessEntity!]!non-null Returns a list of Business Entities associated with the shop.
- Anchor to businessEntitybusiness•
Entity Returns a Business Entity by ID.
- Anchor to carrierServicecarrier•
Service Returns a
object by ID.
- Anchor to carrierServicescarrier•
Services Retrieve a list of CarrierServices.
- Anchor to cartTransformscart•
Transforms CartTransform Connection!non-null List of Cart transform objects owned by the current API client.
- Anchor to cashTrackingSessioncash•
Tracking Session Lookup a cash tracking session by ID.
- Anchor to cashTrackingSessionscash•
Tracking Sessions CashTracking Session Connection!non-null Returns a shop's cash tracking sessions for locations with a POS Pro subscription.
Tip: To query for cash tracking sessions in bulk, you can perform a bulk operation.
- Anchor to catalogcatalog•
Returns a Catalog resource by ID.
- Anchor to catalogOperationscatalog•
Operations [ResourceOperation!]!non-null Returns the most recent catalog operations for the shop.
- Anchor to catalogscatalogs•Catalog
Connection!non-null The catalogs belonging to the shop.
- Anchor to catalogsCountcatalogs•
Count The count of catalogs belonging to the shop. Limited to a maximum of 10000.
- Anchor to checkoutAndAccountsConfigurationcheckout•
And Accounts Configuration A checkout and accounts configuration for a shop.
- Anchor to checkoutAndAccountsConfigurationscheckout•
And Accounts Configurations List of checkout and accounts configurations on a shop.
- Anchor to checkoutBrandingcheckout•
Branding Returns the visual customizations for checkout for a given checkout profile.
To learn more about updating checkout branding settings, refer to the checkoutBrandingUpsert mutation and the checkout branding tutorial.
- Anchor to checkoutProfilecheckout•
Profile A checkout profile on a shop.
- Anchor to checkoutProfilescheckout•
Profiles CheckoutProfile Connection!non-null List of checkout profiles on a shop.
- Anchor to codeDiscountNodecode•
Discount Node Returns a code discount resource by ID.
- Anchor to codeDiscountNodeByCodecode•
Discount Node By Code Returns a code discount identified by its discount code.
- Anchor to codeDiscountNodescode•
Discount Nodes DiscountCode Node Connection!non-null Returns a list of code-based discounts.
- Anchor to codeDiscountSavedSearchescode•
Discount Saved Searches SavedSearch Connection!non-null List of the shop's code discount saved searches.
- Anchor to collectioncollection•
Returns a Collection resource by ID.
- Anchor to collectionByIdentifiercollection•
By Identifier Return a collection by an identifier.
- Anchor to collectionRulesConditionscollection•
Rules Conditions [CollectionRule Conditions!]!non-null Lists all rules that can be used to create smart collections.
- Anchor to collectionscollections•Collection
Connection!non-null Returns a list of collections.
- Anchor to collectionSavedSearchescollection•
Saved Searches SavedSearch Connection!non-null Returns a list of the shop's collection saved searches.
- Anchor to collectionsCountcollections•
Count Count of collections. Limited to a maximum of 10000.
- Anchor to commentcomment•
Returns a Comment resource by ID.
- Anchor to commentscomments•Comment
Connection!non-null List of the shop's comments.
- Anchor to companiescompanies•Company
Connection!non-null Returns the list of companies in the shop.
- Anchor to companiesCountcompanies•
Count The number of companies for a shop.
- Anchor to companycompany•
Returns a
Company
object by ID.- Anchor to companyContactcompany•
Contact Returns a
object by ID.
- Anchor to companyContactRolecompany•
Contact Role Returns a
object by ID.
- Anchor to companyLocationcompany•
Location Returns a
object by ID.
- Anchor to companyLocationscompany•
Locations CompanyLocation Connection!non-null Returns the list of company locations in the shop.
- Anchor to consentPolicyconsent•
Policy [ConsentPolicy!]!non-null Returns the customer privacy consent policies of a shop.
- Anchor to consentPolicyRegionsconsent•
Policy Regions [ConsentPolicy Region!]!non-null List of countries and regions for which consent policies can be created or updated.
- Anchor to currentAppInstallationcurrent•
App Installation AppInstallation!non-null Return the AppInstallation for the currently authenticated App.
- Anchor to currentBulkOperationcurrent•
Bulk Operation Returns the current app's most recent BulkOperation. Apps can run one bulk query and one bulk mutation operation at a time, by shop.
- Anchor to currentStaffMembercurrent•
Staff Member The staff member making the API request.
- Anchor to customercustomer•
Returns a Customer resource by ID.
- Anchor to customerAccountPagecustomer•
Account Page Returns a customer account page.
- Anchor to customerAccountPagescustomer•
Account Pages List of the shop's customer account pages.
- Anchor to customerByIdentifiercustomer•
By Identifier Return a customer by an identifier.
- Anchor to customerMergeJobStatuscustomer•
Merge Job Status Returns the status of a customer merge request job.
- Anchor to customerMergePreviewcustomer•
Merge Preview CustomerMerge Preview!non-null Returns a preview of a customer merge request.
- Anchor to customerPaymentMethodcustomer•
Payment Method Returns a CustomerPaymentMethod resource by its ID.
- Anchor to customerscustomers•Customer
Connection!non-null Returns a list of customers in your Shopify store, including key information such as name, email, location, and purchase history. Use this query to segment your audience, personalize marketing campaigns, or analyze customer behavior by applying filters based on location, order history, marketing preferences and tags. The
customers
query supports pagination and sorting.- Anchor to customerSavedSearchescustomer•
Saved Searches SavedSearch Connection!non-null List of the shop's customer saved searches.
- Anchor to customersCountcustomers•
Count The number of customers.
- Anchor to customerSegmentMemberscustomer
Segment Members