Shopify Connector Objects (GRAPHQL-2024-07 Schema)

NameDescription
AbandonedCheckoutLineItemsRetrieves a list of line items in the associated resource.
AbandonmentReturns abandonment.
AbandonmentProductsAddedToCartReturns the products added to the cart during the customer abandoned visit.
AbandonmentProductsViewedReturns the products viewed during the customer abandoned visit.
AppCreditsLists credits that can be used towards future app purchases.
AppFeedbacksReports the status of shops and their resources and displays this information within Shopify admin. AppFeedback is used to notify merchants about steps they need to take to set up an application on their store.
AppSubscriptionLineItemsReturns the plans attached to the app subscription.
AppSubscriptionsLists all subscriptions created for a shop on the installed application.
ArticleCommentsReturns a list of comments posted on an article.
ArticlesReturns a list of the shop's visible articles.
AssignedFulfillmentOrdersRetrieves a 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, or might currently not be requested to be fulfilled. The app must have 'read_assigned_fulfillment_orders' to be able to retrieve fulfillment orders assigned to its locations. All assigned fulfillment orders (except those with the 'CLOSED' status) will be returned by default.
BlogsRetrieves a list of the shop's blogs.
CarrierServicesReturns a list of activated carrier services and associated shop locations that support them.
CatalogsThe catalogs belonging to the shop.
CollectionProductsRetrieves a list of the products inside of a collection.
CollectionsReturns a list of collections.
CompaniesReturns the list of companies in the shop.
CompanyContactRoleAssignmentsReturns role assignments.
CompanyContactRolesReturns available roles for company contacts.
CompanyContactsReturns contacts for companies.
CompanyEventsRetrieves a paginated list of events associated with the host subject.
CompanyLocationsReturns a list of locations in the company.
CustomerEventsRetrieves a paginated list of events associated with the host subject.
CustomersRetrieves a list of customers.
CustomerSegmentMembersThe list of members, such as customers, that's associated with individual segments.
DeliveryProfileLocationGroupCountriesLists countries already selected in any zone for the specified location group.
DeliveryProfileLocationGroupCountryProvincesReturns the list of regions associated with this country.
DeliveryProfileLocationGroupsLists the location groups using this profile.
DeliveryProfileLocationGroupZonesLists the applicable zones associated to the specified location group.
DeliveryProfilesReturns a list of saved delivery profiles.
DeliveryProfileUnassignedLocationsLists the locations that have not been assigned to a location group for this profile.
DiscountEventsRetrieves a paginated list of events associated with the host subject.
DiscountsAutomaticAppReturns a list of discounts.
DiscountsAutomaticBasicReturns a list of discounts.
DiscountsAutomaticBxgyReturns a list of discounts.
DiscountsCodeAppReturns a list of discounts.
DiscountsCodeBasicReturns a list of discounts.
DiscountsCodeBxgyReturns a list of discounts.
DiscountsCodeFreeShippingReturns a list of discounts.
DraftOrderCustomAttributesRetrieves custom attributes associated with the resource.
DraftOrderEventsRetrieves a paginated list of events associated with the host subject.
DraftOrderLineItemCustomAttributesRetrieves custom attributes associated with the resource.
DraftOrderLineItemsReturns a list of the line items in the draft order.
DraftOrderLineItemTaxLinesRepresents a single tax applied to the associated resource.
DraftOrdersReturns a list of saved draft orders.
DraftOrderTaxLinesRepresents a single tax applied to the associated resource.
FilesReturns the list of files that have been uploaded to Shopify.
FulfillmentEventsRetrieves the history of events associated with one or many fulfillments.
FulfillmentLineItemsLine items from orders that are included in fulfillments.
FulfillmentLineItemTaxLinesRepresents a single tax applied to the associated resource.
FulfillmentOrderLineItemsA list of the fulfillment order's line items.
FulfillmentOrderLocationForMoveAvailableLineItemsA list of the fulfillment order's line items.
FulfillmentOrderLocationForMoveUnavailableLineItemsA list of the fulfillment order's line items.
FulfillmentOrderLocationsForMoveA list of locations that the fulfillment order can potentially move to.
FulfillmentOrdersRetrieves a paginated list of merchant-managed and third-party fulfillment orders.
FulfillmentsFulfillment represents a shipment of one or more items in an order.
FulfillmentServicesLists fulfillmentServices which Represents service that prepares and ships orders on behalf of the store owner.
FulfillmentTrackingInfoLists tracking information associated with the fulfillment, such as the tracking company, tracking number, and tracking URL.
GiftCardsReturns a list of gift cards. Requires read_gift_cards access scope. Also, note that the API client must be a private or custom application installed on a Shopify Plus or Shopify Plus Partner Sandbox store.(This table is available only with a ShopifyPlus subscription)
InventoryItemCountryHarmonizedSystemCodesReturns a list of country specific harmonized system codes.
InventoryItemInventoryLevelQuantitiesList quantities for inventory items at specific locations.
InventoryItemInventoryLevelsReturns overview information of the inventory item for each location that the inventory item can be stocked at.
InventoryItemsReturns a list of inventory items.
JobsReturns a Job resource by ID. Used to check the status of internal jobs and any applicable changes.
LocationsReturns a list of active inventory locations.
MarketingEventsReturns a list of marketing events associated with the marketing app.
MetafieldsRetrieves a list of metafields that belong to one or many resource IDs.
MetaobjectDefinitionsProvides the definition of a generic object structure composed of metafields.
MetaObjectsAll metaobjects for the shop.
OrderAdditionalFeesA list of additional fees applied to the order.
OrderAgreementAdditionalFeeSalesRetrieves a list of sales associated with agreements.
OrderAgreementAdjustmentSalesRetrieves a list of sales associated with agreements.
OrderAgreementDutySalesRetrieves a list of sales associated with agreements.
OrderAgreementGiftCardSalesRetrieves a list of sales associated with agreements.
OrderAgreementProductSalesRetrieves a list of sales associated with agreements.
OrderAgreementsRetrieves a list of sales agreements associated with orders.
OrderAgreementShippingLineSalesRetrieves a list of sales associated with agreements.
OrderAgreementTipSalesRetrieves a list of sales associated with agreements.
OrderAgreementUnknownSalesRetrieves a list of sales associated with agreements.
OrderCustomAttributesRetrieves custom attributes associated with the resource.
OrderDiscountApplicationsReturns a list of discounts that are applied to the order, not including order edits and refunds.
OrderEditAgreementAdditionalFeeSalesRetrieves a list of sales associated with agreements.
OrderEditAgreementAdjustmentSalesRetrieves a list of sales associated with agreements.
OrderEditAgreementDutySalesRetrieves a list of sales associated with agreements.
OrderEditAgreementGiftCardSalesRetrieves a list of sales associated with agreements.
OrderEditAgreementProductSalesRetrieves a list of sales associated with agreements.
OrderEditAgreementsRetrieves a list of sales agreements associated with orders.
OrderEditAgreementShippingLineSalesRetrieves a list of sales associated with agreements.
OrderEditAgreementTipSalesRetrieves a list of sales associated with agreements.
OrderEditAgreementUnknownSalesRetrieves a list of sales associated with agreements.
OrderEventsRetrieves a paginated list of events associated with the host subject.
OrderLineItemCustomAttributesRetrieves custom attributes associated with the resource.
OrderLineItemDiscountAllocationsRetrieves the discounts that have been allocated onto the line item by discount applications, not including order edits and refunds.
OrderLineItemDutiesLists the duties associated with the line items.
OrderLineItemsRetrieves line items associated with orders.
OrderNonFulfillableLineItemDutiesLists the duties associated with the line items.
OrderNonFulfillableLineItemsRetrieves a list of line items in the associated resource.
OrderRefundAgreementAdditionalFeeSalesRetrieves a list of sales associated with agreements.
OrderRefundAgreementAdjustmentSalesRetrieves a list of sales associated with agreements.
OrderRefundAgreementDutySalesRetrieves a list of sales associated with agreements.
OrderRefundAgreementGiftCardSalesRetrieves a list of sales associated with agreements.
OrderRefundAgreementProductSalesRetrieves a list of sales associated with agreements.
OrderRefundAgreementsRetrieves a list of sales agreements associated with orders.
OrderRefundAgreementShippingLineSalesRetrieves a list of sales associated with agreements.
OrderRefundAgreementTipSalesRetrieves a list of sales associated with agreements.
OrderRefundAgreementUnknownSalesRetrieves a list of sales associated with agreements.
OrderRiskAssessmentsRetrieves a list of risk assessments for orders.
OrdersRetrieves a list of orders.
OrderTaxLinesRepresents a single tax applied to the associated resource.
OrderTransactionsRetrieves the transactions associated with the resource.
PagesReturns a list of the shop's pages.
PriceListPricesA list of prices associated with a price list.
PriceListsAll price lists for a shop.
ProductMediaImagesReturns the media images associated with the product.
ProductOptionsReturns a list of product options. The limit is specified by Shop.resourceLimits.maxProductOptions.
ProductOptionValuesList all the corresponding option value objects to the product option, including values not assigned to any variants.
ProductResourceFeedbacksReturns the product resource feedback for the currently authenticated app.
ProductsReturns a list of products.
ProductVariantsReturns a list of the product variants.
PublicationCollectionsReturns a list of collections published to the publication.
PublicationProductsReturns the list of publication for products.
PublicationsReturns the list of publications.
RefundDutiesLists the refunded duties as part of this refund.
RefundLineItemDutiesLists the duties associated with the line items.
RefundLineItemsRetrieves the 'RefundLineItem' resources attached to the refund.
RefundsRepresents a refund of items or transactions in an order.
RefundTransactionFeesReturns the transaction fees charged on the order transaction. Only present for Shopify Payments transactions.
RefundTransactionsRetrieves the transactions associated with the resource.
ReturnExchangeLineItemsRetrieves a list of line items in the associated resource.
ReturnLineItemsRetrieves the return line items attached to the return.
ReturnLineItemsUnverifiedRetrieves the unverified return line items attached to the return.
ReturnsRetrieves a list of returns for the order.
ScriptTagsReturns a list of script tags.
SegmentFilterParametersThe parameters for event segment filters.
SegmentFiltersA list of filters.
SegmentsA list of a shop's segments.
SellingPlanGroupsReturns a list Selling Plan Groups.
SellingPlanGroupSellingPlansRetrieves selling plans associated to the selling plan group.
ShopReturns the Shop resource corresponding to the access token used in the request. The Shop resource contains business and store management settings for the shop.
ShopifyPaymentsAccountReturns Shopify Payments account information, including balances and payouts.
ShopifyPaymentsAccountBalanceReturns current balances in all currencies for the account.
ShopifyPaymentsAccountBalanceTransactionAdjustmentsOrdersThe adjustment orders associated to the transaction.
ShopifyPaymentsAccountBalanceTransactionsA list of balance transactions associated with a Shopify Payments account balance.
ShopifyPaymentsAccountBankAccountsLists all bank accounts configured for the Shopify Payments account.
ShopifyPaymentsAccountDisputesLists all disputes related to the Shopify Payments account.
ShopifyPaymentsAccountPayoutsReturns all current and previous payouts made between the account and the bank account. Its avaible only in a few certain countries.
ShopifyPaymentsAccountPermittedVerificationDocumentsRetrieves the permitted documents for identity verification.
ShopifyPaymentsAccountVerificationsReturns the verifications necessary for this account.
StaffMembersRetrieves a paginated list of the shop's staff members.(This table is available only with a ShopifyPlus subscription)
StorefrontAccessTokensRetrieves the storefront access token of a private application. These are scoped per-application.
TenderTransactionsReturns a list of TenderTransactions associated with the shop.
UrlRedirectsReturns a list of redirects for a shop.
NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
ResourceIdStringFalseAbandonment.AbandonedCheckoutPayloadIdNoA globally-unique ID.
TitleStringFalseNoTitle of the line item. Defaults to the product's title.
ProductIdStringFalseNoA globally-unique ID.
VariantIdStringFalseNoA globally-unique ID.
VariantTitleStringFalseNoThe title of the variant at time of order creation.
QuantityIntFalseNoThe number of variant units ordered.
SkuStringFalseNoThe variant SKU number.
ImageIdStringFalseNoA unique ID for the image.
ImageWidthIntFalseNoThe original width of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
ImageAltTextStringFalseNoA word or phrase to share the nature or contents of an image.
ImageHeightIntFalseNoThe original height of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
ImageUrlStringFalseNoThe location of the image as a URL.
DiscountedTotalPriceSetPresentmentMoneyAmountDecimalFalseNoFinal total price for the entire quantity of this line item, including discounts. Decimal money amount.
DiscountedTotalPriceSetPresentmentMoneyCurrencyCodeStringFalseNoFinal total price for the entire quantity of this line item, including discounts. Currency of the money.
DiscountedTotalPriceSetShopMoneyAmountDecimalFalseNoFinal total price for the entire quantity of this line item, including discounts. Decimal money amount.
DiscountedTotalPriceSetShopMoneyCurrencyCodeStringFalseNoFinal total price for the entire quantity of this line item, including discounts. Currency of the money.
DiscountedTotalPriceWithCodeDiscountPresentmentMoneyAmountDecimalFalseNoThe total price for the entire quantity of this line item, after all discounts are applied, at both the line item and code-based line item level. Decimal money amount.
DiscountedTotalPriceWithCodeDiscountPresentmentMoneyCurrencyCodeStringFalseNoThe total price for the entire quantity of this line item, after all discounts are applied, at both the line item and code-based line item level. Currency of the money.
DiscountedTotalPriceWithCodeDiscountShopMoneyAmountDecimalFalseNoThe total price for the entire quantity of this line item, after all discounts are applied, at both the line item and code-based line item level. Decimal money amount.
DiscountedTotalPriceWithCodeDiscountShopMoneyCurrencyCodeStringFalseNoThe total price for the entire quantity of this line item, after all discounts are applied, at both the line item and code-based line item level. Currency of the money.
DiscountedUnitPriceSetPresentmentMoneyAmountDecimalFalseNoThe price of a single variant unit after discounts are applied at the line item level, in shop and presentment currencies. Decimal money amount.
DiscountedUnitPriceSetPresentmentMoneyCurrencyCodeStringFalseNoThe price of a single variant unit after discounts are applied at the line item level, in shop and presentment currencies. Currency of the money.
DiscountedUnitPriceSetShopMoneyAmountDecimalFalseNoThe price of a single variant unit after discounts are applied at the line item level, in shop and presentment currencies. Decimal money amount.
DiscountedUnitPriceSetShopMoneyCurrencyCodeStringFalseNoThe price of a single variant unit after discounts are applied at the line item level, in shop and presentment currencies. Currency of the money.
DiscountedUnitPriceWithCodeDiscountPresentmentMoneyAmountDecimalFalseNoThe price of a single variant unit after all discounts are applied, at both the line item and code-based line item level. Decimal money amount.
DiscountedUnitPriceWithCodeDiscountPresentmentMoneyCurrencyCodeStringFalseNoThe price of a single variant unit after all discounts are applied, at both the line item and code-based line item level. Currency of the money.
DiscountedUnitPriceWithCodeDiscountShopMoneyAmountDecimalFalseNoThe price of a single variant unit after all discounts are applied, at both the line item and code-based line item level. Decimal money amount.
DiscountedUnitPriceWithCodeDiscountShopMoneyCurrencyCodeStringFalseNoThe price of a single variant unit after all discounts are applied, at both the line item and code-based line item level. Currency of the money.
OriginalTotalPriceSetPresentmentMoneyAmountDecimalFalseNoOriginal total price for the entire quantity of this line item, before discounts. Decimal money amount.
OriginalTotalPriceSetPresentmentMoneyCurrencyCodeStringFalseNoOriginal total price for the entire quantity of this line item, before discounts. Currency of the money.
OriginalTotalPriceSetShopMoneyAmountDecimalFalseNoOriginal total price for the entire quantity of this line item, before discounts. Decimal money amount.
OriginalTotalPriceSetShopMoneyCurrencyCodeStringFalseNoOriginal total price for the entire quantity of this line item, before discounts. Currency of the money.
OriginalUnitPriceSetPresentmentMoneyAmountDecimalFalseNoOriginal price for a single unit of this line item, before discounts. Decimal money amount.
OriginalUnitPriceSetPresentmentMoneyCurrencyCodeStringFalseNoOriginal price for a single unit of this line item, before discounts. Currency of the money.
OriginalUnitPriceSetShopMoneyAmountDecimalFalseNoOriginal price for a single unit of this line item, before discounts. Decimal money amount.
OriginalUnitPriceSetShopMoneyCurrencyCodeStringFalseNoOriginal price for a single unit of this line item, before discounts. Currency of the money.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
AppIdStringFalseNoA globally-unique ID.
CustomerIdStringFalseNoA globally-unique ID.
AbandonmentTypeStringFalseNoThe abandonment type.
EmailStateStringFalseNoThe email state (e.g., sent or not sent).
InventoryAvailableBoolFalseNoWhether the products in abandonment are available.
EmailSentAtDatetimeFalseNoWhen the email was sent, if that is the case.
MostRecentStepStringFalseNoThe most recent step type.
VisitStartedAtDatetimeFalseNoThe date and time when the visit started.
IsFromOnlineStoreBoolFalseNoWhether the abandonment event comes from the Online Store sales channel.
IsFromShopAppBoolFalseNoWhether the abandonment event comes from the Shop app sales channel.
IsFromShopPayBoolFalseNoWhether the abandonment event comes from Shop Pay.
IsMostSignificantAbandonmentBoolFalseNoWhether the customer did not complete another most significant step since this abandonment.
LastBrowseAbandonmentDateDatetimeFalseNoThe date for the latest browse abandonment.
LastCartAbandonmentDateDatetimeFalseNoThe date for the latest cart abandonment.
LastCheckoutAbandonmentDateDatetimeFalseNoThe date for the latest checkout abandonment.
DaysSinceLastAbandonmentEmailIntFalseNoThe number of days since the last abandonment email was sent to the customer.
HoursSinceLastAbandonedCheckoutDoubleFalseNoThe number of hours since the customer has last abandoned a checkout.
CustomerHasNoOrderSinceAbandonmentBoolFalseNoWhether the customer has completed an order since this checkout has been abandoned.
CreatedAtDatetimeFalseNoThe date and time when the abandonment was created.
IsFromCustomStorefrontBoolFalseNoWhether the abandonment event comes from a custom storefront channel.
AbandonedCheckoutPayloadIdStringFalseNoA globally-unique ID.
AbandonedCheckoutPayloadDefaultCursorStringFalseNoA default cursor that returns the single next record, sorted ascending by ID.
AbandonedCheckoutPayloadAbandonedCheckoutUrlStringFalseNoThe URL for the buyer to recover their checkout.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
AbandonmentIdStringFalseNoA globally-unique ID.
AbandonedCheckoutPayloadId [KEY]StringFalseNoA globally-unique ID.
ProductId [KEY]StringFalseNoA globally-unique ID.
VariantId [KEY]StringFalseNoA globally-unique ID.
QuantityIntFalseNoThe quantity of the product that the customer requested.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
AbandonmentIdStringFalseAbandonment.IdNoA globally-unique ID.
AbandonedCheckoutPayloadId [KEY]StringFalseNoA globally-unique ID.
ProductId [KEY]StringFalseNoA globally-unique ID.
VariantId [KEY]StringFalseNoA globally-unique ID.
QuantityIntFalseNoThe quantity of the product that the customer requested.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
AppInstallationIdStringFalseNoA globally-unique ID.
DescriptionStringFalseNoThe description of the app credit.
TestBoolFalseNoWhether the app credit is a test transaction.
CreatedAtDatetimeFalseNoThe date and time when the app credit was created.
AmountDecimalFalseNoDecimal money amount.
AmountCurrencyCodeStringFalseNoCurrency of the money.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
TitleStringTrueNoName of the app.
MessageStringTrueNoThe feedback message presented to the merchant.
UrlStringTrueNoThe URL that the link visits.
LabelStringTrueNoA context-sensitive label for the link.
StateStringFalseYesThe state of the feedback and whether it requires merchant action.
FeedbackGeneratedAtDatetimeFalseYesThe date and time when the feedback was generated. Used to help determine whether incoming feedback is outdated compared to existing feedback.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
AppSubscriptionIdStringTrueNoA globally-unique ID.
AppInstallationIdStringTrueNoA globally-unique ID.
RecurringPricingPlanDiscountDurationLimitInIntervalsIntTrueNoThe total number of billing intervals to which the discount will be applied. The discount will be applied to an indefinite number of billing intervals if this value is blank.
RecurringPricingPlanDiscountPriceAfterDiscountAmountDecimalTrueNoThe price of the subscription after the discount is applied. Decimal money amount.
RecurringPricingPlanDiscountPriceAfterDiscountCurrencyCodeStringTrueNoThe price of the subscription after the discount is applied. Currency of the money.
RecurringPricingPlanDiscountRemainingDurationInIntervalsIntTrueNoThe remaining number of billing intervals to which the discount will be applied.
RecurringPricingPlanValueAmountDecimalTrueNoThe value of the discount applied every billing interval. Decimal money amount.
RecurringPricingPlanValueAmountCurrencyCodeStringTrueNoThe value of the discount applied every billing interval. Currency of the money.
RecurringPricingPlanValuePercentageDoubleTrueNoThe value of the discount applied every billing interval. The percentage value of a discount.
RecurringPricingPlanIntervalStringTrueNoThe frequency at which the subscribing shop is billed for an app subscription.
RecurringPricingPlanPriceAmountDecimalTrueNoThe amount to be charged to the subscribing shop every billing interval. Decimal money amount.
RecurringPricingPlanPriceCurrencyCodeStringTrueNoThe currency to be charged to the subscribing shop every billing interval. Currency of the money.
UsagePricingPlanBalanceUsedAmountDecimalTrueNoThe total usage records for interval. Decimal money amount.
UsagePricingPlanBalanceUsedCurrencyCodeStringTrueNoThe total usage records for interval. Currency of the money.
UsagePricingPlanCappedAmountDecimalFalseNoThe capped amount prevents the merchant from being charged for any usage over that amount during a billing period. This prevents billing from exceeding a maximum threshold over the duration of the billing period. For the merchant to continue using the app after exceeding a capped amount, they would need to agree to a new usage charge. Decimal money amount.
UsagePricingPlanCappedAmountCurrencyCodeStringFalseNoThe capped amount prevents the merchant from being charged for any usage over that amount during a billing period. This prevents billing from exceeding a maximum threshold over the duration of the billing period. For the merchant to continue using the app after exceeding a capped amount, they would need to agree to a new usage charge. Currency of the money.
UsagePricingPlanIntervalStringTrueNoThe frequency with which the app usage records are billed.
UsagePricingPlanTermsStringTrueNoThe terms and conditions for app usage pricing. Must be present in order to create usage charges. The terms are presented to the merchant when they approve an app's usage charges.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
AppInstallationIdStringTrueNoA globally-unique ID.
NameStringTrueNoThe name of the app subscription.
StatusStringTrueNoThe status of the app subscription.
TestBoolTrueNoSpecifies whether the app subscription is a test transaction.
ReturnUrlStringTrueNoThe URL that the merchant is redirected to after approving the app subscription.
TrialDaysIntTrueNoThe number of free trial days, starting at the subscription's creation date, by which billing is delayed.
CurrentPeriodEndDatetimeTrueNoThe date and time when the current app subscription period ends. Returns 'null' if the subscription isn't active.
CreatedAtDatetimeTrueNoThe date and time when the app subscription was created.
LineItemIdsStringTrueNoThe IDs of the plans attached to the app subscription.
LineItemStringTrueNo

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
ArticleIdStringFalseArticles.IdNoA globally-unique ID.
ContentHtmlStringFalseNoThe content of the comment, complete with HTML formatting.
AuthorNameStringFalseNoThe author's name.
AuthorEmailStringFalseNoThe author's email.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
TitleStringFalseNoThe article's name.
HandleStringFalseNoA human-friendly unique string for the Article automatically generated from its title.
TagsStringFalseNoA categorization that a article can be tagged with.
ContentHtmlStringFalseNoThe content of the article, complete with HTML formatting.
ExcerptHtmlStringFalseNoThe excerpt of the article, complete with HTML formatting.
OnlineStoreUrlStringFalseNoThe URL used for viewing the resource on the shop's Online Store. Returns 'null' if the resource is currently not published to the Online Store sales channel.
PublishedAtDatetimeFalseNoThe date and time when the article was published.
AuthorV2NameStringFalseNoThe author's full name.
AuthorV2FirstNameStringFalseNoThe author's first name.
AuthorV2LastNameStringFalseNoThe author's last name.
AuthorV2BioStringFalseNoThe author's bio.
AuthorV2EmailStringFalseNoThe author's email.
BlogIdStringFalseNoA globally-unique ID.
BlogTitleStringFalseNoThe blogs's title.
ImageIdStringFalseNoA unique ID for the image.
ImageWidthIntFalseNoThe original width of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
ImageAltTextStringFalseNoA word or phrase to share the nature or contents of an image.
ImageHeightIntFalseNoThe original height of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
ImageUrlStringFalseNoThe location of the image as a URL.
SeoTitleStringFalseNoThe SEO title.
SeoDescriptionStringFalseNoThe meta description.
CreatedAtDatetimeFalseNoThe date and time when the article was created. This column can only be used as an input for filtering.
UpdatedAtDatetimeFalseNoThe date and time when the article was last updated. This column can only be used as an input for filtering.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
ShopIdStringFalseShop.IdNoA globally-unique ID.
OrderIdStringFalseNoA globally-unique ID.
StatusStringFalseNoThe status of the fulfillment order.
FulfillAtDatetimeFalseNoThe date and time at which the fulfillment order will be fulfillable. When this date and time is reached, the scheduled fulfillment order is automatically transitioned to open. For example, the 'fulfill_at' date for a subscription order might be the 1st of each month, a pre-order 'fulfill_at' date would be 'nil', and a standard order 'fulfill_at' date would be the order creation date.
FulfillByDatetimeFalseNoThe latest date and time by which all items in the fulfillment order need to be fulfilled.
RequestStatusStringFalseNoThe request status of the fulfillment order.
CreatedAtDatetimeFalseNoDate and time when the fulfillment order was created.
UpdatedAtDatetimeFalseNoThe date and time when the fulfillment order was last updated.
AssignedLocationNameStringFalseNoThe name of the location.
AssignedLocationAddress1StringFalseNoThe first line of the address for the location.
AssignedLocationAddress2StringFalseNoThe second line of the address for the location.
AssignedLocationCityStringFalseNoThe city of the location.
AssignedLocationPhoneStringFalseNoThe phone number of the location.
AssignedLocationProvinceStringFalseNoThe province of the location.
AssignedLocationZipStringFalseNoThe ZIP code of the location.
AssignedLocationCountryCodeStringFalseNoThe two-letter country code of the location.
AssignedLocationLocationIdStringFalseNoA globally-unique ID.
AssignedLocationLocationLegacyResourceIdStringFalseNoThe ID of the corresponding resource in the REST Admin API.
AssignedLocationLocationNameStringFalseNoThe name of the location.
AssignedLocationLocationActivatableBoolFalseNoWhether this location can be reactivated.
AssignedLocationLocationDeactivatableBoolFalseNoWhether this location can be deactivated.
AssignedLocationLocationDeletableBoolFalseNoWhether this location can be deleted.
AssignedLocationLocationAddressVerifiedBoolFalseNoWhether the location address has been verified.
AssignedLocationLocationDeactivatedAtStringFalseNoThe date and time that the location was deactivated at. For example, 3: 30 pm on September 7, 2019 in the time zone of UTC (Universal Time Coordinated) is represented as '2019-09-07T15: 50: 00Z'.
AssignedLocationLocationIsActiveBoolFalseNoWhether the location is active.
AssignedLocationLocationShipsInventoryBoolFalseNoWhether this location is used for calculating shipping rates. In multi-origin shipping mode, this flag is ignored.
AssignedLocationLocationFulfillsOnlineOrdersBoolFalseNoWhether this location can fulfill online orders.
AssignedLocationLocationHasActiveInventoryBoolFalseNoWhether this location has active inventory.
AssignedLocationLocationHasUnfulfilledOrdersBoolFalseNoWhether this location has orders that need to be fulfilled.
DeliveryMethodIdStringFalseNoA globally-unique ID.
DeliveryMethodMethodTypeStringFalseNoThe type of the delivery method.
DeliveryMethodMaxDeliveryDateTimeDatetimeFalseNoThe latest delivery date and time when the fulfillment is expected to arrive at the buyer's location.
DeliveryMethodMinDeliveryDateTimeDatetimeFalseNoThe earliest delivery date and time when the fulfillment is expected to arrive at the buyer's location.
DeliveryMethodServiceCodeStringFalseNoA reference to the shipping method.
DeliveryMethodSourceReferenceStringFalseNoPromise provider specific data associated with delivery promise.
DeliveryMethodBrandedPromiseNameStringFalseNoThe name of the branded promise. For example: 'Shop Promise'.
DeliveryMethodBrandedPromiseHandleStringFalseNoThe handle of the branded promise. For example: 'shop_promise'.
DeliveryMethodAdditionalInformationPhoneStringFalseNoThe phone number to contact when performing the delivery.
DeliveryMethodAdditionalInformationInstructionsStringFalseNoThe delivery instructions to follow when performing the delivery.
DestinationIdStringFalseNoA globally-unique ID.
DestinationFirstNameStringFalseNoThe first name of the customer at the destination.
DestinationLastNameStringFalseNoThe last name of the customer at the destination.
DestinationAddress1StringFalseNoThe first line of the address of the destination.
DestinationAddress2StringFalseNoThe second line of the address of the destination.
DestinationCityStringFalseNoThe city of the destination.
DestinationCompanyStringFalseNoThe company of the destination.
DestinationEmailStringFalseNoThe email of the customer at the destination.
DestinationPhoneStringFalseNoThe phone number of the customer at the destination.
DestinationProvinceStringFalseNoThe province of the destination.
DestinationZipStringFalseNoThe ZIP code of the destination.
DestinationCountryCodeStringFalseNoThe two-letter country code of the destination.
InternationalDutiesIncotermStringFalseNoThe method of duties payment. Example values: 'DDP', 'DAP'.
AssignmentStatusStringFalseNoThe assigment status of the fulfillment orders that should be returned. If assignmentStatus argument is not provided, then the query will return all assigned fulfillment orders, except those that have the CLOSED status.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
TitleStringFalseNoThe blogs's title.
HandleStringFalseNoA human-friendly unique string for the Blog automatically generated from its title.
OnlineStoreUrlStringFalseNoThe URL used for viewing the resource on the shop's Online Store. Returns 'null' if the resource is currently not published to the Online Store sales channel.
SeoTitleStringFalseNoThe SEO title.
SeoDescriptionStringFalseNoThe meta description.
CreatedAtDatetimeFalseNoThe date and time when the blog was created. This column can only be used as an input for filtering.
UpdatedAtDatetimeFalseNoThe date and time when the blog was last updated. This column can only be used as an input for filtering.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
IdStringFalseNoA globally-unique ID.
NameStringFalseNoThe name of the shipping service provider.
FormattedNameStringFalseNoThe properly formatted name of the shipping service provider, ready to display.
IconAltTextStringFalseNoA word or phrase to share the nature or contents of an image.
IconHeightIntFalseNoThe original height of the image in pixels. Returns null if the image isn't hosted by Shopify.
IconIdStringFalseNoA unique ID for the image.
IconWidthIntFalseNoThe original width of the image in pixels. Returns null if the image isn't hosted by Shopify.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
StatusStringFalseNoThe status of the catalog.
TitleStringFalseNoThe name of the catalog.
PriceListIdStringFalseNoA globally-unique ID.
PublicationIdStringFalseNoA globally-unique ID.
OperationIdStringTrueNoA globally-unique ID.
CompanyLocationIdsStringFalseYesThe IDs of the company locations to associate to the catalog.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoGlobally unique identifier.
CollectionId [KEY]StringFalseCollections.IdNoA globally-unique identifier for the collection.
TitleStringFalseNoThe title of the product.
PositionIntFalseNoThe position in which the products are sorted.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
LegacyResourceIdStringTrueNoThe ID of the corresponding resource in the REST Admin API.
TitleStringTrueNoThe name of the collection. It's displayed in the Shopify admin and is typically displayed in sales channels, such as an online store.
HandleStringTrueNoA unique string that identifies the collection. If a handle isn't specified when a collection is created, it's automatically generated from the collection's original title, and typically includes words from the title separated by hyphens. For example, a collection that was created with the title 'Summer Catalog 2022' might have the handle 'summer-catalog-2022'. If the title is changed, the handle doesn't automatically change. The handle can be used in themes by the Liquid templating language to refer to the collection, but using the ID is preferred because it never changes.
DescriptionHtmlStringTrueNoThe description of the collection, including any HTML tags and formatting. This content is typically displayed to customers, such as on an online store, depending on the theme.
ProductsCountIntTrueNoThe number of products in the collection.
ProductsCountPrecisionStringTrueNoThe count's precision, or the exactness of the value.
SortOrderStringFalseNoThe order in which the products in the collection are displayed by default in the Shopify admin and in sales channels, such as an online store.
TemplateSuffixStringTrueNoThe suffix of the Liquid template being used to show the collection in an online store. For example, if the value is 'custom', then the collection is using the 'collection. custom. liquid' template. If the value is 'null', then the collection is using the default 'collection. liquid' template.
AvailablePublicationsCountIntTrueNoThe number of publications a resource is published to without feedback errors.
AvailablePublicationsCountPrecisionStringTrueNoThe count's precision, or the exactness of the value.
PublishedOnCurrentPublicationBoolTrueNoCheck to see whether the resource is published to the calling app's publication.
UpdatedAtDatetimeTrueNoThe date and time when the collection was last modified.
FeedbackSummaryStringTrueNoSummary of resource feedback pertaining to the resource.
ImageIdStringTrueNoA unique ID for the image.
ImageWidthIntTrueNoThe original width of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
ImageAltTextStringTrueNoA word or phrase to share the nature or contents of an image.
ImageHeightIntTrueNoThe original height of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
ImageUrlStringTrueNoThe location of the image as a URL.
RuleSetAppliedDisjunctivelyBoolTrueNoWhether products must match any or all of the rules to be included in the collection. If true, then products must match at least one of the rules to be included in the collection. If false, then products must match all of the rules to be included in the collection.
SeoTitleStringTrueNoSEO Title.
SeoDescriptionStringTrueNoSEO Description.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
ExternalIdStringFalseNoA unique externally-supplied ID for the company.
NameStringFalseNoThe name of the company.
NoteStringFalseNoA note about the company.
ContactsCountIntTrueNoThe number of contacts that belong to the company.
ContactsCountPrecisionStringTrueNoThe count's precision, or the exactness of the value.
CustomerSinceDatetimeTrueNoThe date and time at which the company became the customer.
DefaultCursorStringTrueNoA default cursor that returns the single next record, sorted ascending by ID.
LifetimeDurationStringTrueNoThe lifetime duration of the company, since it became a customer of the shop. Examples: '2 days', '3 months', '1 year'.
LocationsCountIntTrueNoThe number of locations that belong to the company.
LocationsCountPrecisionStringTrueNoThe count's precision, or the exactness of the value.
OrdersCountIntTrueNoThe total number of orders placed for this company, across all its locations.
OrdersCountPrecisionStringTrueNoThe count's precision, or the exactness of the value.
HasTimelineCommentBoolTrueNoWhether the merchant added a timeline comment to the company.
CreatedAtDatetimeTrueNoThe date and time at which the company was created in Shopify.
UpdatedAtDatetimeTrueNoThe date and time at which the company was last modified.
DefaultRoleIdStringTrueNoA globally-unique ID.
DefaultRoleNameStringTrueNoThe name of a role. For example, 'admin' or 'buyer'.
DefaultRoleNoteStringTrueNoA note for the role.
MainContactIdStringTrueNoA globally-unique ID.
TotalSpentAmountDecimalTrueNoDecimal money amount.
TotalSpentCurrencyCodeStringTrueNoCurrency of the money.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
CompanyIdStringTrueNoThe company this role assignment belongs to.
CompanyLocationIdStringTrueNoThe company location to which the role is assigned.
CompanyContactIdStringTrueNoThe company contact for whom this role is assigned.
CreatedAtDatetimeTrueNoThe date and time when the assignment record was created.
UpdatedAtDatetimeTrueNoThe date and time when the assignment record was last updated.
RoleIdStringTrueNoA globally-unique ID.
RoleNameStringTrueNoThe name of a role. For example, 'admin' or 'buyer'.
RoleNoteStringTrueNoA note for the role.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
CompanyIdStringFalseNoThe company to which the role belongs.
Id [KEY]StringFalseNoA globally-unique ID.
NameStringFalseNoThe name of a role. For example, 'admin' or 'buyer'.
NoteStringFalseNoA note for the role.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
CompanyIdStringTrueNoThe company to which the contact belongs.
Id [KEY]StringTrueNoA globally-unique ID.
IsMainContactBoolTrueNoWhether the contact is the main contact of the company.
TitleStringFalseNoThe company contact's job title.
LocaleStringFalseNoThe company contact's locale (language).
LifetimeDurationStringTrueNoThe lifetime duration of the company contact, since its creation date on Shopify. Examples: '1 year', '2 months', '3 days'.
CreatedAtDatetimeTrueNoThe date and time at which the company contact was created at Shopify.
UpdatedAtDatetimeTrueNoThe date and time at which the company contact was last updated.
CustomerIdStringTrueNoThe customer associated to this contact.
CustomerFirstNameStringFalseNoThe customer's first name.
CustomerLastNameStringFalseNoThe customer's last name.
CustomerEmailStringFalseNoThe customer's email address.
CustomerPhoneStringFalseNoThe customer's phone number.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
HostIdStringFalseCompanies.IdNoA globally-unique ID.
AppTitleStringFalseNoThe name of the app that created the event.
AttributeToAppBoolFalseNoWhether the event was created by an app.
AttributeToUserBoolFalseNoWhether the event was caused by an admin user.
CreatedAtDatetimeFalseNoThe date and time when the event was created.
CriticalAlertBoolFalseNoWhether the event is critical.
MessageStringFalseNoHuman readable text that describes the event.
CommentEventAuthorIdStringFalseNoThe id of the staff member that authored the comment event.
CommentEventCanDeleteBoolFalseNoWhether the comment event can be deleted. If true, then the comment event can be deleted.
CommentEventCanEditBoolFalseNoWhether the comment event can edited. If true, then the comment event can be edited.
CommentEventEditedBoolFalseNoWhether the comment event has been edited. If true, then the comment event has been edited.
CommentEventRawMessageStringFalseNoThe raw body of the comment event.
CommentEventSubjectIdStringFalseNoThe parent subject to which the comment event belongs.
CommentEventEmbedCustomerIdStringFalseNoThe object reference associated with the comment event.
CommentEventEmbedDraftOrderIdStringFalseNoThe object reference associated with the comment event.
CommentEventEmbedOrderIdStringFalseNoThe object reference associated with the comment event.
CommentEventEmbedProductIdStringFalseNoThe object reference associated with the comment event.
CommentEventEmbedProductVariantIdStringFalseNoThe object reference associated with the comment event.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
CompanyIdStringTrueCompanies.IdNoA globally-unique ID.
ExternalIdStringFalseNoA unique externally-supplied ID for the company location.
TaxRegistrationIdStringTrueNoThe tax registration ID for the company location.
NameStringFalseNoThe name of the company location.
CurrencyStringTrueNoThe location's currency based on the shipping address. If the shipping address is empty, then the value is the shop's primary market.
LocaleStringFalseNoThe preferred locale of the company location.
NoteStringFalseNoA note about the company location.
PhoneStringFalseNoThe phone number of the company location.
DefaultCursorStringTrueNoA default cursor that returns the single next record, sorted ascending by ID.
OrdersCountIntTrueNoThe total number of orders placed for the location.
OrdersCountPrecisionStringTrueNoThe count's precision, or the exactness of the value.
TaxExemptionsStringTrueNoThe list of tax exemptions applied to the location.
HasTimelineCommentBoolTrueNoWhether the merchant added a timeline comment to the company location.
CreatedAtDatetimeTrueNoThe date and time at which the company location was created in Shopify.
UpdatedAtDatetimeTrueNoThe date and time at which the company location was last modified.
BillingAddressIdStringTrueNoA globally-unique ID.
BillingAddressCompanyNameStringTrueNoThe name of the company.
BillingAddressFirstNameStringTrueNoThe first name of the recipient.
BillingAddressLastNameStringTrueNoThe last name of the recipient.
BillingAddressAddress1StringTrueNoThe first line of the address. Typically the street address or PO Box number.
BillingAddressAddress2StringTrueNoThe second line of the address. Typically the number of the apartment, suite, or unit.
BillingAddressCityStringTrueNoThe name of the city, district, village, or town.
BillingAddressCountryStringTrueNoThe name of the country.
BillingAddressPhoneStringTrueNoA unique phone number for the customer. Formatted using E. 164 standard. For example, +16135551111.
BillingAddressProvinceStringTrueNoThe region of the address, such as the province, state, or district.
BillingAddressRecipientStringTrueNoThe identity of the recipient e. g. 'Receiving Department'.
BillingAddressZipStringTrueNoThe zip or postal code of the address.
BillingAddressCountryCodeStringTrueNoThe two-letter code for the country of the address. For example, US.
BillingAddressFormattedAreaStringTrueNoA comma-separated list of the values for city, province, and country.
BillingAddressZoneCodeStringTrueNoThe two-letter code for the region. For example, ON.
BillingAddressCreatedAtDatetimeTrueNoThe date and time at which the company address was created.
BillingAddressUpdatedAtDatetimeTrueNoThe date and time at which the company address was last updated.
BuyerExperienceConfigurationCheckoutToDraftBoolTrueNoWhether to checkout to draft order for merchant review.
BuyerExperienceConfigurationPayNowOnlyBoolTrueNoWhether a buyer must pay at checkout or they can also choose to pay later using net terms.
BuyerExperienceConfigurationPaymentTermsTemplateIdStringTrueNoA globally-unique ID.
BuyerExperienceConfigurationPaymentTermsTemplateNameStringTrueNoThe name of the payment terms template.
BuyerExperienceConfigurationPaymentTermsTemplateTranslatedNameStringTrueNoThe translated payment terms template name.
BuyerExperienceConfigurationPaymentTermsTemplateDescriptionStringTrueNoThe description of the payment terms template.
BuyerExperienceConfigurationPaymentTermsTemplateDueInDaysIntTrueNoThe number of days between the issued date and due date if this is the net type of payment terms.
BuyerExperienceConfigurationPaymentTermsTemplatePaymentTermsTypeStringTrueNoThe type of the payment terms template.
MarketIdStringTrueNoA globally-unique ID.
ShippingAddressIdStringTrueNoA globally-unique ID.
ShippingAddressCompanyNameStringTrueNoThe name of the company.
ShippingAddressFirstNameStringTrueNoThe first name of the recipient.
ShippingAddressLastNameStringTrueNoThe last name of the recipient.
ShippingAddressAddress1StringTrueNoThe first line of the address. Typically the street address or PO Box number.
ShippingAddressAddress2StringTrueNoThe second line of the address. Typically the number of the apartment, suite, or unit.
ShippingAddressCityStringTrueNoThe name of the city, district, village, or town.
ShippingAddressCountryStringTrueNoThe name of the country.
ShippingAddressPhoneStringTrueNoA unique phone number for the customer. Formatted using E. 164 standard. For example, +16135551111.
ShippingAddressProvinceStringTrueNoThe region of the address, such as the province, state, or district.
ShippingAddressRecipientStringTrueNoThe identity of the recipient e. g. 'Receiving Department'.
ShippingAddressZipStringTrueNoThe zip or postal code of the address.
ShippingAddressCountryCodeStringTrueNoThe two-letter code for the country of the address. For example, US.
ShippingAddressFormattedAreaStringTrueNoA comma-separated list of the values for city, province, and country.
ShippingAddressZoneCodeStringTrueNoThe two-letter code for the region. For example, ON.
ShippingAddressCreatedAtDatetimeTrueNoThe date and time at which the company address was created.
ShippingAddressUpdatedAtDatetimeTrueNoThe date and time at which the company address was last updated.
TotalSpentAmountDecimalTrueNoDecimal money amount.
TotalSpentCurrencyCodeStringTrueNoCurrency of the money.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
HostIdStringFalseCustomers.IdNoA globally-unique ID.
AppTitleStringFalseNoThe name of the app that created the event.
AttributeToAppBoolFalseNoWhether the event was created by an app.
AttributeToUserBoolFalseNoWhether the event was caused by an admin user.
CreatedAtDatetimeFalseNoThe date and time when the event was created.
CriticalAlertBoolFalseNoWhether the event is critical.
MessageStringFalseNoHuman readable text that describes the event.
CommentEventAuthorIdStringFalseNoThe id of the staff member that authored the comment event.
CommentEventCanDeleteBoolFalseNoWhether the comment event can be deleted. If true, then the comment event can be deleted.
CommentEventCanEditBoolFalseNoWhether the comment event can edited. If true, then the comment event can be edited.
CommentEventEditedBoolFalseNoWhether the comment event has been edited. If true, then the comment event has been edited.
CommentEventRawMessageStringFalseNoThe raw body of the comment event.
CommentEventSubjectIdStringFalseNoThe parent subject to which the comment event belongs.
CommentEventEmbedCustomerIdStringFalseNoThe object reference associated with the comment event.
CommentEventEmbedDraftOrderIdStringFalseNoThe object reference associated with the comment event.
CommentEventEmbedOrderIdStringFalseNoThe object reference associated with the comment event.
CommentEventEmbedProductIdStringFalseNoThe object reference associated with the comment event.
CommentEventEmbedProductVariantIdStringFalseNoThe object reference associated with the comment event.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
MultipassIdentifierStringTrueNoA unique identifier for the customer that's used with Multipass login.
LegacyResourceIdStringTrueNoThe ID of the corresponding resource in the REST Admin API.
ValidEmailAddressBoolTrueNoWhether the email address is formatted correctly. Returns 'true' when the email is formatted correctly and belongs to an existing domain. This doesn't guarantee that the email address actually exists.
DisplayNameStringTrueNoThe full name of the customer, based on the values for first_name and last_name. If the first_name and last_name are not available, then this falls back to the customer's email address, and if that is not available, the customer's phone number.
FirstNameStringFalseNoThe customer's first name.
LastNameStringFalseNoThe customer's last name.
EmailStringFalseNoThe customer's email address.
LocaleStringFalseNoThe customer's locale.
NoteStringFalseNoA note about the customer.
PhoneStringFalseNoThe customer's phone number.
StateStringTrueNoThe state of the customer's account with the shop.
TagsStringFalseNoA comma separated list of tags that have been added to the customer.
CanDeleteBoolTrueNoWhether the merchant can delete the customer from their store. A customer can be deleted from a store only if they have not yet made an order. After a customer makes an order, they can't be deleted from a store.
LifetimeDurationStringTrueNoThe amount of time since the customer was first added to the store. Example: 'about 12 years'.
TaxExemptBoolFalseNoWhether the customer is exempt from being charged taxes on their orders.
TaxExemptionsStringFalseNoThe list of tax exemptions applied to the customer.
UnsubscribeUrlStringTrueNoThe URL to unsubscribe the customer from the mailing list.
VerifiedEmailBoolTrueNoWhether the customer has verified their email address. Defaults to 'true' if the customer is created through the Shopify admin or API.
NumberOfOrdersStringTrueNoThe number of orders that the customer has made at the store in their lifetime.
ProductSubscriberStatusStringTrueNoPossible subscriber states of a customer defined by their subscription contracts.
CreatedAtDatetimeTrueNoThe date and time when the customer was added to the store.
UpdatedAtDatetimeTrueNoThe date and time when the customer was last updated.
AmountSpentAmountDecimalTrueNoDecimal money amount.
AmountSpentCurrencyCodeStringTrueNoCurrency of the money.
DefaultAddressIdStringTrueNoA globally-unique ID.
DefaultAddressCoordinatesValidatedBoolTrueNoWhether the address coordinates are valid.
DefaultAddressNameStringTrueNoThe full name of the customer, based on firstName and lastName.
DefaultAddressFirstNameStringFalseNoThe first name of the customer.
DefaultAddressLastNameStringFalseNoThe last name of the customer.
DefaultAddressAddress1StringFalseNoThe first line of the address. Typically the street address or PO Box number.
DefaultAddressAddress2StringFalseNoThe second line of the address. Typically the number of the apartment, suite, or unit.
DefaultAddressCityStringFalseNoThe name of the city, district, village, or town.
DefaultAddressCompanyStringFalseNoThe name of the customer's company or organization.
DefaultAddressCountryStringFalseNoThe name of the country.
DefaultAddressLatitudeDoubleTrueNoThe latitude coordinate of the customer address.
DefaultAddressLongitudeDoubleTrueNoThe longitude coordinate of the customer address.
DefaultAddressPhoneStringFalseNoA unique phone number for the customer. Formatted using E. 164 standard. For example, +16135551111.
DefaultAddressProvinceStringFalseNoThe region of the address, such as the province, state, or district.
DefaultAddressZipStringFalseNoThe zip or postal code of the address.
DefaultAddressFormattedAreaStringTrueNoA comma-separated list of the values for city, province, and country.
DefaultAddressProvinceCodeStringFalseNoThe two-letter code for the region. For example, ON.
DefaultAddressCountryCodeV2StringFalseNoThe two-letter code for the country of the address. For example, US.
EmailMarketingConsentMarketingStateStringTrueNoThe current email marketing state for the customer.
EmailMarketingConsentMarketingOptInLevelStringTrueNoThe marketing subscription opt-in level, as described by the M3AAWG best practices guidelines, that the customer gave when they consented to receive marketing material by email.
EmailMarketingConsentConsentUpdatedAtDatetimeTrueNoThe date and time at which the customer consented to receive marketing material by email. The customer's consent state reflects the consent record with the most recent 'consent_updated_at' date. If no date is provided, then the date and time at which the consent information was sent is used.
ImageIdStringTrueNoA unique ID for the image.
ImageWidthIntTrueNoThe original width of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
ImageAltTextStringTrueNoA word or phrase to share the nature or contents of an image.
ImageHeightIntTrueNoThe original height of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
ImageUrlStringTrueNoThe location of the image as a URL.
LastOrderIdStringTrueNoA globally-unique ID.
MarketIdStringTrueNoA globally-unique ID.
MergeableReasonStringTrueNoThe reason why the customer can't be merged with another customer.
MergeableErrorFieldsStringTrueNoThe list of fields preventing the customer from being merged.
MergeableIsMergeableBoolTrueNoWhether the customer can be merged with another customer.
MergeableMergeInProgressJobIdStringTrueNoThe UUID of the merge job.
MergeableMergeInProgressResultingCustomerIdStringTrueNoThe ID of the customer resulting from the merge.
MergeableMergeInProgressStatusStringTrueNoThe status of the customer merge request.
SmsMarketingConsentMarketingStateStringFalseNoThe current SMS marketing state for the customer.
SmsMarketingConsentConsentCollectedFromStringTrueNoThe source from which the SMS marketing information for the customer was collected.
SmsMarketingConsentMarketingOptInLevelStringFalseNoThe marketing subscription opt-in level that was set when the customer consented to receive marketing information.
SmsMarketingConsentConsentUpdatedAtDatetimeFalseNoThe date and time when the customer consented to receive marketing material by SMS. If no date is provided, then the date and time when the consent information was sent is used.
StatisticsPredictedSpendTierStringTrueNoThe predicted spend tier of a customer with a shop.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
SegmentId [KEY]StringFalseSegments.IdNoThe ID of the segment.
Id [KEY]StringFalseNoThe member's ID.
DisplayNameStringFalseNoThe full name of the member, which is based on the values of the 'first_name' and 'last_name' fields. If the member's first name and last name aren't available, then the customer's email address is used. If the customer's email address isn't available, then the customer's phone number is used.
FirstNameStringFalseNoThe member's first name.
LastNameStringFalseNoThe member's last name.
NoteStringFalseNoA note about the member.
LastOrderIdStringFalseNoThe ID of the member's most recent order.
NumberOfOrdersStringFalseNoThe total number of orders that the member has made.
AmountSpentAmountDecimalFalseNoDecimal money amount.
AmountSpentCurrencyCodeStringFalseNoCurrency of the money.
DefaultAddressIdStringFalseNoA globally-unique ID.
DefaultAddressCountryStringFalseNoThe name of the country.
DefaultAddressProvinceStringFalseNoThe region of the address, such as the province, state, or district.
DefaultAddressCityStringFalseNoThe name of the city, district, village, or town.
DefaultAddressFormattedAreaStringFalseNoA comma-separated list of the values for city, province, and country.
DefaultAddressCompanyStringFalseNoThe name of the customer's company or organization.
DefaultAddressAddress1StringFalseNoThe first line of the address. Typically the street address or PO Box number.
DefaultAddressAddress2StringFalseNoThe second line of the address. Typically the number of the apartment, suite, or unit.
DefaultAddressNameStringFalseNoThe full name of the customer, based on firstName and lastName.
DefaultAddressFirstNameStringFalseNoThe first name of the customer.
DefaultAddressLastNameStringFalseNoThe last name of the customer.
DefaultAddressLatitudeDoubleFalseNoThe latitude coordinate of the customer address.
DefaultAddressLongitudeDoubleFalseNoThe longitude coordinate of the customer address.
DefaultAddressCoordinatesValidatedBoolFalseNoWhether the address coordinates are valid.
DefaultAddressPhoneStringFalseNoA unique phone number for the customer. Formatted using E. 164 standard. For example, +16135551111.
DefaultAddressZipStringFalseNoThe zip or postal code of the address.
DefaultAddressProvinceCodeStringFalseNoThe alphanumeric code for the region. For example, ON.
DefaultAddressCountryCodeStringFalseNoThe two-letter code for the country of the address. For example, US.
DefaultAddressTimeZoneStringFalseNoThe time zone of the address.
DefaultEmailAddressEmailAddressStringFalseNoThe customer's default email address.
DefaultEmailAddressMarketingStateStringFalseNoWhether the customer has subscribed to email marketing.
DefaultEmailAddressMarketingUnsubscribeUrlStringFalseNoThe URL to unsubscribe a member from all mailing lists.
DefaultEmailAddressOpenTrackingLevelStringFalseNoWhether the customer has opted in to having their opened emails tracked.
DefaultEmailAddressOpenTrackingUrlStringFalseNoThe URL that can be used to opt a customer in or out of email open tracking.
DefaultPhoneNumberMarketingStateStringFalseNoWhether the customer has subscribed to SMS marketing material.
DefaultPhoneNumberPhoneNumberStringFalseNoA customer's phone number.
MergeableReasonStringFalseNoThe reason why the customer can't be merged with another customer.
MergeableErrorFieldsStringFalseNoThe list of fields preventing the customer from being merged.
MergeableIsMergeableBoolFalseNoWhether the customer can be merged with another customer.
MergeableMergeInProgressJobIdStringFalseNoThe UUID of the merge job.
MergeableMergeInProgressResultingCustomerIdStringFalseNoThe ID of the customer resulting from the merge.
MergeableMergeInProgressStatusStringFalseNoThe status of the customer merge request.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
CountryId [KEY]StringFalseNoA globally-unique ID.
LocationGroupId [KEY]StringFalseNoA globally-unique ID.
DeliveryProfileIdStringFalseNoThe ID of the DeliveryProfile to return.
ZoneStringFalseNoThe name of the shipping zone.
CountryNameStringFalseNoThe full name of the country.
CountryTranslatedNameStringFalseNoThe translated name of the country. The translation returned is based on the system's locale.
CountryCodeCountryCodeStringFalseNoThe country code in the ISO 3166-1 alpha-2 format.
CountryCodeRestOfWorldBoolFalseNoWhether the country is a part of the 'Rest of World' shipping zone.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
CountryIdStringFalseNoA globally-unique ID.
CodeStringFalseNoThe code of the region.
NameStringFalseNoThe full name of the region.
TranslatedNameStringFalseNoThe translated name of the region. The translation returned is based on the system's locale.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
DeliveryProfileIdStringFalseNoThe ID of the DeliveryProfile to return.
LocationsCountIntFalseNoA count of all locations that are part of this location group.
LocationsCountPrecisionStringFalseNoThe count's precision, or the exactness of the value.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
LocationGroupId [KEY]StringFalseNoFilter the location groups of the profile by location group ID.
DeliveryProfileIdStringFalseDeliveryProfiles.IdNoThe ID of the DeliveryProfile to return.
NameStringFalseNoThe name of the zone.
MethodDefinitionCountsParticipantDefinitionsCountIntFalseNoThe number of participant method definitions for the specified zone.
MethodDefinitionCountsRateDefinitionsCountIntFalseNoThe number of merchant-defined method definitions for the specified zone.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
NameStringFalseNoThe name of the delivery profile.
DefaultBoolTrueNoWhether this is the default profile.
LegacyModeBoolTrueNoWhether this shop has enabled legacy compatibility mode for delivery profiles.
OriginLocationCountIntTrueNoThe number of active origin locations for the profile.
ZoneCountryCountIntTrueNoThe number of countries with active rates to deliver to.
ActiveMethodDefinitionsCountIntTrueNoThe number of active shipping rates for the profile.
LocationsWithoutRatesCountIntTrueNoThe number of locations without rates defined.
ProductVariantsCountIntTrueNoThe product variant count.
ProductVariantsCountPrecisionStringTrueNoThe count's precision, or the exactness of the value.
MerchantOwnedOnlyBoolTrueNoIf 'true', returns only delivery profiles that were created by the merchant.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
DeliveryProfileId [KEY]StringFalseDeliveryProfiles.IdNoA globally-unique ID.
LocationId [KEY]StringFalseLocations.IdNoA globally-unique ID.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
HostIdStringFalseNoA globally-unique ID.
AppTitleStringFalseNoThe name of the app that created the event.
AttributeToAppBoolFalseNoWhether the event was created by an app.
AttributeToUserBoolFalseNoWhether the event was caused by an admin user.
CreatedAtDatetimeFalseNoThe date and time when the event was created.
CriticalAlertBoolFalseNoWhether the event is critical.
MessageStringFalseNoHuman readable text that describes the event.
CommentEventAuthorIdStringFalseNoThe id of the staff member that authored the comment event.
CommentEventCanDeleteBoolFalseNoWhether the comment event can be deleted. If true, then the comment event can be deleted.
CommentEventCanEditBoolFalseNoWhether the comment event can edited. If true, then the comment event can be edited.
CommentEventEditedBoolFalseNoWhether the comment event has been edited. If true, then the comment event has been edited.
CommentEventRawMessageStringFalseNoThe raw body of the comment event.
CommentEventSubjectIdStringFalseNoThe parent subject to which the comment event belongs.
CommentEventEmbedCustomerIdStringFalseNoThe object reference associated with the comment event.
CommentEventEmbedDraftOrderIdStringFalseNoThe object reference associated with the comment event.
CommentEventEmbedOrderIdStringFalseNoThe object reference associated with the comment event.
CommentEventEmbedProductIdStringFalseNoThe object reference associated with the comment event.
CommentEventEmbedProductVariantIdStringFalseNoThe object reference associated with the comment event.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
DiscountIdStringTrueNoThe ID for the discount.
TitleStringFalseNoThe title of the discount.
StatusStringTrueNoThe status of the discount.
DiscountClassStringTrueNoThe class of the discount for combining purposes.
EndsAtDatetimeFalseNoThe date and time when the discount ends. For open-ended discounts, use 'null'.
StartsAtDatetimeFalseNoThe date and time when the discount starts.
AsyncUsageCountIntTrueNoThe number of times the discount has been used. This value is updated asynchronously and can be different than the actual usage count.
CreatedAtDatetimeTrueNoThe date and time when the discount was created.
UpdatedAtDatetimeTrueNoThe date and time when the discount was updated.
AppDiscountTypeFunctionIdStringFalseNoThe ID of the function providing the app discount type.
AppDiscountTypeTitleStringTrueNoThe title of the app discount type.
AppDiscountTypeDescriptionStringTrueNoA description of the app discount type.
AppDiscountTypeAppKeyStringTrueNoThe client ID of the app providing the app discount type.
AppDiscountTypeDiscountClassStringTrueNoThe class of the app discount type.
AppDiscountTypeTargetTypeStringTrueNoThe target type of the app discount type. Possible values: 'SHIPPING_LINE' and 'LINE_ITEM'.
CombinesWithOrderDiscountsBoolFalseNoCombines with order discounts.
CombinesWithProductDiscountsBoolFalseNoCombines with product discounts.
CombinesWithShippingDiscountsBoolFalseNoCombines with shipping discounts.
ErrorHistoryFirstOccurredAtDatetimeTrueNoThe date and time that the first error occurred.
ErrorHistoryErrorsFirstOccurredAtDatetimeTrueNoThe date and time that the first error occurred.
ErrorHistoryHasSharedRecentErrorsBoolTrueNoWhether the merchant has shared all the recent errors with the developer.
ErrorHistoryHasBeenSharedSinceLastErrorBoolTrueNoWhether the merchant has shared all the recent errors with the developer.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
TitleStringFalseNoThe title of the discount.
StatusStringTrueNoThe status of the discount.
SummaryStringTrueNoA detailed summary of the discount.
DiscountClassStringTrueNoThe class of the discount for combining purposes.
EndsAtDatetimeFalseNoThe date and time when the discount ends. For open-ended discounts, use 'null'.
ShortSummaryStringTrueNoA short summary of the discount.
StartsAtDatetimeFalseNoThe date and time when the discount starts.
AsyncUsageCountIntTrueNoThe number of times the discount has been used. This value is updated asynchronously and can be different than the actual usage count.
CreatedAtDatetimeTrueNoThe date and time when the discount was created.
CombinesWithOrderDiscountsBoolFalseNoCombines with order discounts.
CombinesWithProductDiscountsBoolFalseNoCombines with product discounts.
CombinesWithShippingDiscountsBoolFalseNoCombines with shipping discounts.
DiscountMinimumQuantityGreaterThanOrEqualToQuantityStringTrueNoThe minimum quantity of items that's required for the discount to be applied.
AppliesOnEachItemBoolFalseYesIf true, then the discount is applied to each of the entitled items. If false, then the amount is split across all of the entitled items.
DiscountAmountDecimalFalseYesThe value of the discount.
ProductsToAddStringFalseYesA simple, comma-separated list of products IDs to add.
ProductsToRemoveStringFalseYesA simple, comma-separated list of products IDs to remove.
MinimumQuantityStringFalseYesThe minimum quantity of items that's required for the discount to be applied.
MinimumSubtotalStringFalseYesThe minimum subtotal that's required for the discount to be applied.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
TitleStringFalseNoThe title of the discount.
StatusStringTrueNoThe status of the discount.
SummaryStringTrueNoA detailed summary of the discount.
DiscountClassStringTrueNoThe class of the discount for combining purposes.
EndsAtDatetimeFalseNoThe date and time when the discount ends. For open-ended discounts, use 'null'.
StartsAtDatetimeFalseNoThe date and time when the discount starts.
AsyncUsageCountIntTrueNoThe number of times the discount has been used. This value is updated asynchronously and can be different than the actual usage count.
UsesPerOrderLimitIntFalseNoThe maximum number of times that the discount can be applied to an order.
CreatedAtDatetimeTrueNoThe date and time when the discount was created.
CombinesWithOrderDiscountsBoolFalseNoCombines with order discounts.
CombinesWithProductDiscountsBoolFalseNoCombines with product discounts.
CombinesWithShippingDiscountsBoolFalseNoCombines with shipping discounts.
DiscountOnQuantityStringFalseYesThe value of the discount.
DiscountPercentageDoubleFalseYesThe value of the discount.
ProductsToAddStringFalseYesA simple, comma-separated list of products IDs to add.
ProductsToRemoveStringFalseYesA simple, comma-separated list of products IDs to remove.
DiscountQuantityToBuyStringFalseYesThe quantity of prerequisite items.
DiscountAmountToBuyStringFalseYesThe value of the discount.
ProductsBuysToAddStringFalseYesA simple, comma-separated list of products IDs to add.
ProductsBuysToRemoveStringFalseYesA simple, comma-separated list of products IDs to remove.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
DiscountIdStringTrueNoThe ID for the discount.
TitleStringFalseNoThe title of the discount.
StatusStringTrueNoThe status of the discount.
CodesCountIntTrueNoThe number of redeem codes for the discount.
CodesCountPrecisionStringTrueNoThe count's precision, or the exactness of the value.
DiscountClassStringTrueNoThe class of the discount for combining purposes.
EndsAtDatetimeFalseNoThe date and time when the discount ends. For open-ended discounts, use 'null'.
StartsAtDatetimeFalseNoThe date and time when the discount starts.
UsageLimitIntFalseNoThe maximum number of times that the discount can be used.
AsyncUsageCountIntTrueNoThe number of times that the discount has been used.
HasTimelineCommentBoolTrueNoIndicates whether there are any timeline comments on the discount.
RecurringCycleLimitIntTrueNoThe number of times a discount applies on recurring purchases (subscriptions).
AppliesOncePerCustomerBoolFalseNoWhether the discount can be applied only once per customer.
CreatedAtDatetimeTrueNoThe date and time when the discount was created.
AppDiscountTypeFunctionIdStringFalseNoThe ID of the function providing the app discount type.
AppDiscountTypeTitleStringTrueNoThe title of the app discount type.
AppDiscountTypeDescriptionStringTrueNoA description of the app discount type.
AppDiscountTypeAppKeyStringTrueNoThe client ID of the app providing the app discount type.
AppDiscountTypeDiscountClassStringTrueNoThe class of the app discount type.
AppDiscountTypeTargetTypeStringTrueNoThe target type of the app discount type. Possible values: 'SHIPPING_LINE' and 'LINE_ITEM'.
CombinesWithOrderDiscountsBoolFalseNoCombines with order discounts.
CombinesWithProductDiscountsBoolFalseNoCombines with product discounts.
CombinesWithShippingDiscountsBoolFalseNoCombines with shipping discounts.
DiscountCustomerAllAllCustomersBoolFalseNoWhether the discount can be applied by all customers. This value is always 'true'.
ErrorHistoryFirstOccurredAtDatetimeTrueNoThe date and time that the first error occurred.
ErrorHistoryErrorsFirstOccurredAtDatetimeTrueNoThe date and time that the first error occurred.
ErrorHistoryHasSharedRecentErrorsBoolTrueNoWhether the merchant has shared all the recent errors with the developer.
ErrorHistoryHasBeenSharedSinceLastErrorBoolTrueNoWhether the merchant has shared all the recent errors with the developer.
TotalSalesAmountDecimalTrueNoDecimal money amount.
TotalSalesCurrencyCodeStringTrueNoCurrency of the money.
CodeStringFalseYesThe code to use the discount.
AddAllCustomersBoolFalseYesWhether all customers can use this discount.
CustomersToAddStringFalseYesA simple, comma-separated list of customers IDs to add.
CustomersToRemoveStringFalseYesA simple, comma-separated list of customers IDs to remove.
CustomerSegmentsToAddStringFalseYesA simple, comma-separated list of customers IDs to add.
CustomerSegmentsToRemoveStringFalseYesA simple, comma-separated list of customers IDs to remove.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
TitleStringFalseNoThe title of the discount.
StatusStringTrueNoThe status of the discount.
SummaryStringTrueNoA detailed summary of the discount.
CodesCountIntTrueNoThe number of redeem codes for the discount.
CodesCountPrecisionStringTrueNoThe count's precision, or the exactness of the value.
DiscountClassStringTrueNoThe class of the discount for combining purposes.
EndsAtDatetimeFalseNoThe date and time when the discount ends. For open-ended discounts, use 'null'.
ShortSummaryStringTrueNoA short summary of the discount.
StartsAtDatetimeFalseNoThe date and time when the discount starts.
UsageLimitIntFalseNoThe maximum number of times that the discount can be used.
AsyncUsageCountIntTrueNoThe number of times that the discount has been used.
HasTimelineCommentBoolTrueNoIndicates whether there are any timeline comments on the discount.
RecurringCycleLimitIntFalseNoThe number of times a discount applies on recurring purchases (subscriptions).
AppliesOncePerCustomerBoolFalseNoWhether the discount can be applied only once per customer.
CreatedAtDatetimeTrueNoThe date and time when the discount was created.
CombinesWithOrderDiscountsBoolFalseNoCombines with order discounts.
CombinesWithProductDiscountsBoolFalseNoCombines with product discounts.
CombinesWithShippingDiscountsBoolFalseNoCombines with shipping discounts.
CustomerGetsAppliesOnSubscriptionBoolFalseNoWhether the discount applies on subscription items.
CustomerGetsAppliesOnOneTimePurchaseBoolFalseNoWhether the discount applies on regular one-time-purchase items.
DiscountCustomerAllAllCustomersBoolFalseNoWhether the discount can be applied by all customers. This value is always 'true'.
DiscountMinimumQuantityGreaterThanOrEqualToQuantityStringFalseNoThe minimum quantity of items that's required for the discount to be applied.
TotalSalesAmountDecimalTrueNoDecimal money amount.
TotalSalesCurrencyCodeStringTrueNoCurrency of the money.
CodeStringFalseYesThe code to use the discount.
AppliesOnEachItemBoolFalseYesIf true, then the discount is applied to each of the entitled items. If false, then the amount is split across all of the entitled items.
DiscountAmountDecimalFalseYesThe value of the discount.
ProductsToAddStringFalseYesA simple, comma-separated list of products IDs to add.
ProductsToRemoveStringFalseYesA simple, comma-separated list of products IDs to remove.
AddAllCustomersBoolFalseYesWhether all customers can use this discount.
CustomersToAddStringFalseYesA simple, comma-separated list of customers IDs to add.
CustomersToRemoveStringFalseYesA simple, comma-separated list of customers IDs to remove.
CustomerSegmentsToAddStringFalseYesA simple, comma-separated list of customers IDs to add.
CustomerSegmentsToRemoveStringFalseYesA simple, comma-separated list of customers IDs to remove.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
TitleStringFalseNoThe title of the discount.
StatusStringTrueNoThe status of the discount.
SummaryStringTrueNoA detailed summary of the discount.
CodesCountIntTrueNoThe number of redeem codes for the discount.
CodesCountPrecisionStringTrueNoThe count's precision, or the exactness of the value.
DiscountClassStringTrueNoThe class of the discount for combining purposes.
EndsAtDatetimeFalseNoThe date and time when the discount ends. For open-ended discounts, use 'null'.
StartsAtDatetimeFalseNoThe date and time when the discount starts.
UsageLimitIntFalseNoThe maximum number of times that the discount can be used.
AsyncUsageCountIntTrueNoThe number of times that the discount has been used.
HasTimelineCommentBoolTrueNoIndicates whether there are any timeline comments on the discount.
AppliesOncePerCustomerBoolFalseNoWhether the discount can be applied only once per customer.
UsesPerOrderLimitIntFalseNoThe maximum number of times that the discount can be applied to an order.
CreatedAtDatetimeTrueNoThe date and time when the discount was created.
CombinesWithOrderDiscountsBoolFalseNoCombines with order discounts.
CombinesWithProductDiscountsBoolFalseNoCombines with product discounts.
CombinesWithShippingDiscountsBoolFalseNoCombines with shipping discounts.
CustomerGetsAppliesOnSubscriptionBoolTrueNoWhether the discount applies on subscription items.
CustomerGetsAppliesOnOneTimePurchaseBoolTrueNoWhether the discount applies on regular one-time-purchase items.
DiscountCustomerAllAllCustomersBoolTrueNoWhether the discount can be applied by all customers. This value is always 'true'.
TotalSalesAmountDecimalTrueNoDecimal money amount.
TotalSalesCurrencyCodeStringTrueNoCurrency of the money.
CodeStringFalseYesThe code to use the discount.
DiscountOnQuantityStringFalseYesThe value of the discount.
DiscountPercentageDoubleFalseYesThe value of the discount.
ProductsToAddStringFalseYesA simple, comma-separated list of products IDs to add.
ProductsToRemoveStringFalseYesA simple, comma-separated list of products IDs to remove.
DiscountAmountToBuyStringFalseYesThe value of the discount.
DiscountQuantityToBuyDoubleFalseYesThe quantity of prerequisite items.
ProductsBuysToAddStringFalseYesA simple, comma-separated list of products IDs to add.
ProductsBuysToRemoveStringFalseYesA simple, comma-separated list of products IDs to remove.
AddAllCustomersBoolFalseYesWhether all customers can use this discount.
CustomersToAddStringFalseYesA simple, comma-separated list of customers IDs to add.
CustomersToRemoveStringFalseYesA simple, comma-separated list of customers IDs to remove.
CustomerSegmentsToAddStringFalseYesA simple, comma-separated list of customers IDs to add.
CustomerSegmentsToRemoveStringFalseYesA simple, comma-separated list of customers IDs to remove.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
TitleStringFalseNoThe title of the discount.
StatusStringFalseNoThe status of the discount.
SummaryStringFalseNoA detailed summary of the discount.
CodesCountIntFalseNoThe number of redeem codes for the discount.
CodesCountPrecisionStringFalseNoThe count's precision, or the exactness of the value.
DiscountClassStringFalseNoThe class of the discount for combining purposes.
EndsAtDatetimeFalseNoThe date and time when the discount ends. For open-ended discounts, use 'null'.
ShortSummaryStringFalseNoA short summary of the discount.
StartsAtDatetimeFalseNoThe date and time when the discount starts.
UsageLimitIntFalseNoThe maximum number of times that the discount can be used.
AppliesOnSubscriptionBoolFalseNoWhether the discount applies on subscription shipping lines.
AsyncUsageCountIntFalseNoThe number of times that the discount has been used.
HasTimelineCommentBoolFalseNoIndicates whether there are any timeline comments on the discount.
RecurringCycleLimitIntFalseNoThe number of times a discount applies on recurring purchases (subscriptions).
AppliesOncePerCustomerBoolFalseNoWhether the discount can be applied only once per customer.
AppliesOnOneTimePurchaseBoolFalseNoWhether the discount applies on regular one-time-purchase shipping lines.
CreatedAtDatetimeFalseNoThe date and time when the discount was created.
CombinesWithOrderDiscountsBoolFalseNoCombines with order discounts.
CombinesWithProductDiscountsBoolFalseNoCombines with product discounts.
CombinesWithShippingDiscountsBoolFalseNoCombines with shipping discounts.
DiscountCustomerAllAllCustomersBoolFalseNoWhether the discount can be applied by all customers. This value is always 'true'.
DiscountCountriesCountriesStringFalseNoThe codes for the countries where the discount can be applied.
DiscountCountriesIncludeRestOfWorldBoolFalseNoWhether the discount is applicable to countries that have not been defined in the shop's shipping zones.
DiscountCountryAllAllCountriesBoolFalseNoWhether the discount can be applied to all countries as shipping destination. This value is always 'true'.
MaximumShippingPriceAmountDecimalFalseNoDecimal money amount.
MaximumShippingPriceCurrencyCodeStringFalseNoCurrency of the money.
DiscountMinimumQuantityGreaterThanOrEqualToQuantityStringFalseNoThe minimum quantity of items that's required for the discount to be applied.
TotalSalesAmountDecimalFalseNoDecimal money amount.
TotalSalesCurrencyCodeStringFalseNoCurrency of the money.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
ResourceId [KEY]StringFalseDraftOrders.IdNoA globally-unique ID.
Key [KEY]StringFalseNoKey or name of the attribute.
ValueStringFalseNoValue of the attribute.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
HostIdStringFalseDraftOrders.IdNoA globally-unique ID.
AppTitleStringFalseNoThe name of the app that created the event.
AttributeToAppBoolFalseNoWhether the event was created by an app.
AttributeToUserBoolFalseNoWhether the event was caused by an admin user.
CreatedAtDatetimeFalseNoThe date and time when the event was created.
CriticalAlertBoolFalseNoWhether the event is critical.
MessageStringFalseNoHuman readable text that describes the event.
CommentEventAuthorIdStringFalseNoThe id of the staff member that authored the comment event.
CommentEventCanDeleteBoolFalseNoWhether the comment event can be deleted. If true, then the comment event can be deleted.
CommentEventCanEditBoolFalseNoWhether the comment event can edited. If true, then the comment event can be edited.
CommentEventEditedBoolFalseNoWhether the comment event has been edited. If true, then the comment event has been edited.
CommentEventRawMessageStringFalseNoThe raw body of the comment event.
CommentEventSubjectIdStringFalseNoThe parent subject to which the comment event belongs.
CommentEventEmbedCustomerIdStringFalseNoThe object reference associated with the comment event.
CommentEventEmbedDraftOrderIdStringFalseNoThe object reference associated with the comment event.
CommentEventEmbedOrderIdStringFalseNoThe object reference associated with the comment event.
CommentEventEmbedProductIdStringFalseNoThe object reference associated with the comment event.
CommentEventEmbedProductVariantIdStringFalseNoThe object reference associated with the comment event.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
ResourceId [KEY]StringFalseDraftOrderLineItems.IdNoA globally-unique ID.
Key [KEY]StringFalseNoKey or name of the attribute.
ValueStringFalseNoValue of the attribute.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
DraftOrderIdStringFalseDraftOrders.IdNoA globally-unique ID.
NameStringFalseNoThe name of the product.
TitleStringFalseNoThe title of the product or variant. This field only applies to custom line items.
VariantTitleStringFalseNoThe name of the variant.
CustomBoolFalseNoWhether the line item is a custom line item ('true') or a product variant line item ('false').
QuantityIntFalseNoThe number of product variants that are requested in the draft order.
SkuStringFalseNoThe SKU number of the product variant.
TaxableBoolFalseNoWhether the variant is taxable.
VendorStringFalseNoThe name of the vendor who created the product variant.
RequiresShippingBoolFalseNoWhether physical shipping is required for the variant.
IsGiftCardBoolFalseNoWhether the line item is a gift card.
AppliedDiscountTitleStringFalseNoName of the order-level discount.
AppliedDiscountDescriptionStringFalseNoDescription of the order-level discount.
AppliedDiscountValueDoubleFalseNoThe order level discount amount. If 'valueType' is 'percentage', then 'value' is the percentage discount.
AppliedDiscountValueTypeStringFalseNoType of the order-level discount.
AppliedDiscountAmountV2AmountDecimalFalseNoDecimal money amount.
AppliedDiscountAmountV2CurrencyCodeStringFalseNoCurrency of the money.
DiscountedTotalSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
DiscountedTotalSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
DiscountedTotalSetShopMoneyAmountDecimalFalseNoDecimal money amount.
DiscountedTotalSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
DiscountedUnitPriceSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
DiscountedUnitPriceSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
DiscountedUnitPriceSetShopMoneyAmountDecimalFalseNoDecimal money amount.
DiscountedUnitPriceSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
FulfillmentServiceIdStringFalseNoThe ID of the fulfillment service.
ImageIdStringFalseNoA unique ID for the image.
ImageWidthIntFalseNoThe original width of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
ImageAltTextStringFalseNoA word or phrase to share the nature or contents of an image.
ImageHeightIntFalseNoThe original height of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
ImageUrlStringFalseNoThe location of the image as a URL.
OriginalTotalSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
OriginalTotalSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
OriginalTotalSetShopMoneyAmountDecimalFalseNoDecimal money amount.
OriginalTotalSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
OriginalUnitPriceSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
OriginalUnitPriceSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
OriginalUnitPriceSetShopMoneyAmountDecimalFalseNoDecimal money amount.
OriginalUnitPriceSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
ProductIdStringFalseNoA globally-unique ID.
TotalDiscountSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
TotalDiscountSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
TotalDiscountSetShopMoneyAmountDecimalFalseNoDecimal money amount.
TotalDiscountSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
VariantIdStringFalseNoA globally-unique ID.
WeightValueDoubleFalseNoThe weight value using the unit system specified with 'unit'.
WeightUnitStringFalseNoThe unit of measurement for 'value'.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Title [KEY]StringFalseNoThe name of the tax.
ResourceId [KEY]StringFalseDraftOrderLineItems.IdNoA globally-unique ID.
RateDoubleFalseNoThe proportion of the line item price that the tax represents as a decimal.
ChannelLiableBoolFalseNoWhether the channel that submitted the tax line is liable for remitting. A value of null indicates unknown liability for this tax line.
RatePercentageDoubleFalseNoThe proportion of the line item price that the tax represents as a percentage.
PriceSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
PriceSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
PriceSetShopMoneyAmountDecimalFalseNoDecimal money amount.
PriceSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
LegacyResourceIdStringTrueNoThe ID of the corresponding resource in the REST Admin API.
NameStringTrueNoThe identifier for the draft order, which is unique within the store. For example, #D1223.
MarketNameStringTrueNoThe name of the selected market.
EmailStringFalseNoEmail address of the customer, which is used to send notifications to.
Note2StringTrueNoThe text from an optional note attached to the draft order.
PhoneStringTrueNoThe phone number assigned to the draft order.
ReadyBoolTrueNoWhether the Draft Order is ready and can be completed. Draft Orders might have asynchronous operations that can take time to finish.
StatusStringTrueNoStatus of the draft order.
TagsStringTrueNoA comma separated list of tags associated with the draft order. Updating 'tags' overwrites any existing tags that were previously added to the draft order. To add new tags without overwriting existing tags, use the mutation.
CompletedAtDatetimeTrueNoThe date and time when the draft order converted to a new order, and the draft order's status changed to Completed.
CurrencyCodeStringTrueNoThe three letter code for the currency of the store at the time of the most recent update to the draft order.
DefaultCursorStringTrueNoA default cursor that returns the single next record, sorted ascending by ID.
InvoiceUrlStringTrueNoThe link to the checkout, which is sent to the customer in the invoice email.
TaxExemptBoolTrueNoWhether the draft order is tax exempt.
TaxesIncludedBoolTrueNoWhether the line item prices include taxes.
TotalWeightStringTrueNoThe total weight in grams of the draft order.
HasTimelineCommentBoolTrueNoWhether the merchant has added timeline comments to the draft order.
InvoiceSentAtDatetimeTrueNoThe date and time when the invoice was last emailed to the customer.
PresentmentCurrencyCodeStringTrueNoThe payment currency of the customer for this draft order.
ReserveInventoryUntilDatetimeTrueNoThe time after which inventory will automatically be restocked.
VisibleToCustomerBoolTrueNoWhether the draft order will be visible to the customer on the self-serve portal.
InvoiceEmailTemplateSubjectStringTrueNoThe subject defined for the draft invoice email template.
MarketRegionCountryCodeStringTrueNoThe selected market region country code for the draft order.
BillingAddressMatchesShippingAddressBoolTrueNoWhether the billing address matches the shipping address.
CreatedAtDatetimeTrueNoThe date and time when the draft order was created in Shopify.
UpdatedAtDatetimeTrueNoThe date and time when the draft order was last changed. The format is YYYY-MM-DD HH: mm: ss. For example, 2016-02-05 17: 04: 01.
OrderIdStringTrueNoA globally-unique ID.
PurchasingEntityCustomerIdStringTrueNoA globally-unique ID.
PurchasingEntityCompanyCompanyIdStringTrueNoA globally-unique ID.
CustomerIdStringFalseCustomers.IdNoCustomer who will be sent an invoice for the draft order, if there is one.
BillingAddressIdStringFalseNoA globally-unique ID.
BillingAddressCoordinatesValidatedBoolTrueNoWhether the address coordinates are valid.
BillingAddressNameStringTrueNoThe full name of the customer, based on firstName and lastName.
BillingAddressFirstNameStringFalseNoThe first name of the customer.
BillingAddressLastNameStringFalseNoThe last name of the customer.
BillingAddressAddress1StringFalseNoThe first line of the address. Typically the street address or PO Box number.
BillingAddressAddress2StringFalseNoThe second line of the address. Typically the number of the apartment, suite, or unit.
BillingAddressCityStringFalseNoThe name of the city, district, village, or town.
BillingAddressCompanyStringFalseNoThe name of the customer's company or organization.
BillingAddressCountryStringFalseNoThe name of the country.
BillingAddressLatitudeDoubleTrueNoThe latitude coordinate of the customer address.
BillingAddressLongitudeDoubleTrueNoThe longitude coordinate of the customer address.
BillingAddressPhoneStringFalseNoA unique phone number for the customer. Formatted using E. 164 standard. For example, +16135551111.
BillingAddressProvinceStringFalseNoThe region of the address, such as the province, state, or district.
BillingAddressZipStringFalseNoThe zip or postal code of the address.
BillingAddressFormattedAreaStringTrueNoA comma-separated list of the values for city, province, and country.
BillingAddressProvinceCodeStringFalseNoThe two-letter code for the region. For example, ON.
BillingAddressCountryCodeV2StringFalseNoThe two-letter code for the country of the address. For example, US.
ShippingAddressIdStringFalseNoA globally-unique ID.
ShippingAddressCoordinatesValidatedBoolTrueNoWhether the address coordinates are valid.
ShippingAddressNameStringTrueNoThe full name of the customer, based on firstName and lastName.
ShippingAddressFirstNameStringFalseNoThe first name of the customer.
ShippingAddressLastNameStringFalseNoThe last name of the customer.
ShippingAddressAddress1StringFalseNoThe first line of the address. Typically the street address or PO Box number.
ShippingAddressAddress2StringFalseNoThe second line of the address. Typically the number of the apartment, suite, or unit.
ShippingAddressCityStringFalseNoThe name of the city, district, village, or town.
ShippingAddressCompanyStringFalseNoThe name of the customer's company or organization.
ShippingAddressCountryStringFalseNoThe name of the country.
ShippingAddressLatitudeDoubleTrueNoThe latitude coordinate of the customer address.
ShippingAddressLongitudeDoubleTrueNoThe longitude coordinate of the customer address.
ShippingAddressPhoneStringFalseNoA unique phone number for the customer. Formatted using E. 164 standard. For example, +16135551111.
ShippingAddressProvinceStringFalseNoThe region of the address, such as the province, state, or district.
ShippingAddressZipStringFalseNoThe zip or postal code of the address.
ShippingAddressFormattedAreaStringTrueNoA comma-separated list of the values for city, province, and country.
ShippingAddressProvinceCodeStringFalseNoThe two-letter code for the region. For example, ON.
ShippingAddressCountryCodeV2StringFalseNoThe two-letter code for the country of the address. For example, US.
ShippingLineIdStringTrueNoA globally-unique ID.
ShippingLineCarrierIdentifierStringTrueNoA reference to the carrier service that provided the rate. Present when the rate was computed by a third-party carrier service.
ShippingLineTitleStringTrueNoReturns the title of the shipping line.
ShippingLineCodeStringTrueNoA reference to the shipping method.
ShippingLineCustomBoolTrueNoWhether the shipping line is custom or not.
ShippingLinePhoneStringTrueNoThe phone number at the shipping address.
ShippingLineSourceStringTrueNoReturns the rate source for the shipping line.
ShippingLineDeliveryCategoryStringTrueNoThe general classification of the delivery method.
ShippingLineShippingRateHandleStringTrueNoA unique identifier for the shipping rate. The format can change without notice and is not meant to be shown to users.
ShippingLineRequestedFulfillmentServiceIdStringTrueNoThe ID of the fulfillment service.
AppliedDiscountTitleStringFalseNoName of the order-level discount.
AppliedDiscountDescriptionStringFalseNoDescription of the order-level discount.
AppliedDiscountValueDoubleFalseNoAmount of the order level discount (when value_type is percentage, the value in this field is the percentage discount).
AppliedDiscountValueTypeStringFalseNoType of the order-level discount.
PaymentTermsIdStringTrueNoA globally-unique ID.
PaymentTermsTranslatedNameStringTrueNoThe payment terms name, translated into the shop admin's preferred language.
PaymentTermsPaymentTermsNameStringTrueNoThe name of the payment terms template used to create the payment terms.
PaymentTermsOverdueBoolTrueNoWhether the payment terms have overdue payment schedules.
PaymentTermsDueInDaysIntTrueNoDuration of payment terms in days based on the payment terms template used to create the payment terms.
PaymentTermsPaymentTermsTypeStringTrueNoThe payment terms template type used to create the payment terms.
PaymentTermsOrderIdStringTrueNoA globally-unique ID.
AppliedDiscountAmountV2AmountDecimalFalseNoDecimal money amount.
AppliedDiscountAmountV2CurrencyCodeStringTrueNoCurrency of the money.
LineItemsSubtotalPricePresentmentMoneyAmountDecimalTrueNoDecimal money amount.
LineItemsSubtotalPricePresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
LineItemsSubtotalPriceShopMoneyAmountDecimalTrueNoDecimal money amount.
LineItemsSubtotalPriceShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
SubtotalPriceSetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
SubtotalPriceSetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
SubtotalPriceSetShopMoneyAmountDecimalTrueNoDecimal money amount.
SubtotalPriceSetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
TotalDiscountsSetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
TotalDiscountsSetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
TotalDiscountsSetShopMoneyAmountDecimalTrueNoDecimal money amount.
TotalDiscountsSetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
TotalLineItemsPriceSetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
TotalLineItemsPriceSetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
TotalLineItemsPriceSetShopMoneyAmountDecimalTrueNoDecimal money amount.
TotalLineItemsPriceSetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
TotalPriceSetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
TotalPriceSetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
TotalPriceSetShopMoneyAmountDecimalTrueNoDecimal money amount.
TotalPriceSetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
TotalShippingPriceSetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
TotalShippingPriceSetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
TotalShippingPriceSetShopMoneyAmountDecimalTrueNoDecimal money amount.
TotalShippingPriceSetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
TotalTaxSetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
TotalTaxSetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
TotalTaxSetShopMoneyAmountDecimalTrueNoDecimal money amount.
TotalTaxSetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
DraftOrderLineItemsStringFalseNoThe list of the line items in the draft order.
DiscountCodesStringFalseNoThe discount codes used for the draft order.
AcceptAutomaticDiscountsBoolFalseNoWhether or not to accept automatic discounts on the draft order during calculation.
AllowDiscountCodesInCheckoutBoolFalseNoWhether discount codes are allowed during checkout of this draft order.
WarningsStringTrueNoThe list of warnings raised while calculating.
PlatformDiscountIdsStringTrueNoThe list of platform discounts applied.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Title [KEY]StringFalseNoThe name of the tax.
ResourceId [KEY]StringFalseDraftOrders.IdNoA globally-unique ID.
RateDoubleFalseNoThe proportion of the line item price that the tax represents as a decimal.
ChannelLiableBoolFalseNoWhether the channel that submitted the tax line is liable for remitting. A value of null indicates unknown liability for this tax line.
RatePercentageDoubleFalseNoThe proportion of the line item price that the tax represents as a percentage.
PriceSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
PriceSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
PriceSetShopMoneyAmountDecimalFalseNoDecimal money amount.
PriceSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
DescriptionStringTrueNoThe description of the file.
StatusStringTrueNoThe status of the file.
FileErrorsStringTrueNoAny errors that have occurred on the file.
CreatedAtDatetimeTrueNoThe date and time at which the file was created in Shopify.
UpdatedAtDatetimeTrueNoThe date and time at which the file was last modified.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
FulfillmentIdStringTrueFulfillments.IdNoA globally-unique ID.
OrderIdStringTrueOrders.IdNoA globally-unique identifier.
StatusStringTrueNoThe status of this fulfillment event.
HappenedAtDatetimeTrueNoThe time at which this fulfillment event happened.
Address1StringTrueNoThe street address where this fulfillment event occurred.
CityStringTrueNoThe city where this fulfillment event occurred.
CountryStringTrueNoThe country where this fulfillment event occurred.
LatitudeDoubleTrueNoThe latitude where this fulfillment event occurred.
LongitudeDoubleTrueNoThe longitude where this fulfillment event occurred.
MessageStringTrueNoA message associated with this fulfillment event.
ProvinceStringTrueNoThe province where this fulfillment event occurred.
ZipStringTrueNoThe zip code of the location where this fulfillment event occurred.
EstimatedDeliveryAtDatetimeTrueNoThe estimated delivery date and time of the fulfillment.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
FulfillmentIdStringFalseFulfillments.IdNoA globally-unique ID.
DiscountedTotalSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
DiscountedTotalSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
DiscountedTotalSetShopMoneyAmountDecimalFalseNoDecimal money amount.
DiscountedTotalSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
OriginalTotalSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
OriginalTotalSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
OriginalTotalSetShopMoneyAmountDecimalFalseNoDecimal money amount.
OriginalTotalSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
QuantityIntFalseNoNumber of line items in the fulfillment.
LineItemIdStringFalseNoA globally-unique ID.
LineItemNameStringFalseNoThe title of the product, optionally appended with the title of the variant (if applicable).
LineItemTitleStringFalseNoThe title of the product at time of order creation.
LineItemVariantTitleStringFalseNoThe title of the variant at time of order creation.
LineItemVariantIdStringFalseNoA globally-unique ID.
LineItemProductIdStringFalseNoA globally-unique ID.
LineItemSellingPlanSellingPlanIdStringFalseNoThe ID of the selling plan associated with the line item.
LineItemQuantityIntFalseNoThe number of variant units ordered.
LineItemRestockableBoolFalseNoWhether the line item can be restocked.
LineItemSkuStringFalseNoThe variant SKU number.
LineItemTaxableBoolFalseNoWhether the variant is taxable.
LineItemVendorStringFalseNoThe name of the vendor who made the variant.
LineItemCurrentQuantityIntFalseNoThe line item's quantity, minus the removed quantity.
LineItemMerchantEditableBoolFalseNoWhether the line item can be edited or not.
LineItemRefundableQuantityIntFalseNoThe line item's quantity, minus the removed quantity.
LineItemRequiresShippingBoolFalseNoWhether physical shipping is required for the variant.
LineItemUnfulfilledQuantityIntFalseNoThe number of units not yet fulfilled.
LineItemNonFulfillableQuantityIntFalseNoThe total number of units that can't be fulfilled. For example, if items have been refunded, or the item is not something that can be fulfilled, like a tip. Please see the object for more fulfillment details.
LineItemIsGiftCardBoolFalseNoWhether the line item represents the purchase of a gift card.
LineItemDiscountedTotalSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
LineItemDiscountedTotalSetPresentmentMoneyAmountWithCodeDiscountsDecimalFalseNoDecimal money amount.
LineItemDiscountedTotalSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
LineItemDiscountedTotalSetShopMoneyAmountDecimalFalseNoDecimal money amount.
LineItemDiscountedTotalSetShopMoneyAmountWithCodeDiscountsDecimalFalseNoDecimal money amount.
LineItemDiscountedTotalSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
LineItemDiscountedUnitPriceSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
LineItemDiscountedUnitPriceSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
LineItemDiscountedUnitPriceSetShopMoneyAmountDecimalFalseNoDecimal money amount.
LineItemDiscountedUnitPriceSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
LineItemImageIdStringFalseNoA unique ID for the image.
LineItemImageWidthIntFalseNoThe original width of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
LineItemImageAltTextStringFalseNoA word or phrase to share the nature or contents of an image.
LineItemImageHeightIntFalseNoThe original height of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
LineItemImageUrlStringFalseNoThe location of the image as a URL.
LineItemOriginalTotalSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
LineItemOriginalTotalSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
LineItemOriginalTotalSetShopMoneyAmountDecimalFalseNoDecimal money amount.
LineItemOriginalTotalSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
LineItemOriginalUnitPriceSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
LineItemOriginalUnitPriceSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
LineItemOriginalUnitPriceSetShopMoneyAmountDecimalFalseNoDecimal money amount.
LineItemOriginalUnitPriceSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
LineItemTotalDiscountSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
LineItemTotalDiscountSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
LineItemTotalDiscountSetShopMoneyAmountDecimalFalseNoDecimal money amount.
LineItemTotalDiscountSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
LineItemUnfulfilledDiscountedTotalSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
LineItemUnfulfilledDiscountedTotalSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
LineItemUnfulfilledDiscountedTotalSetShopMoneyAmountDecimalFalseNoDecimal money amount.
LineItemUnfulfilledDiscountedTotalSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
LineItemUnfulfilledOriginalTotalSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
LineItemUnfulfilledOriginalTotalSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
LineItemUnfulfilledOriginalTotalSetShopMoneyAmountDecimalFalseNoDecimal money amount.
LineItemUnfulfilledOriginalTotalSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Title [KEY]StringFalseNoThe name of the tax.
ResourceId [KEY]StringFalseFulfillmentLineItems.IdNoA globally-unique ID.
RateDoubleFalseNoThe proportion of the line item price that the tax represents as a decimal.
ChannelLiableBoolFalseNoWhether the channel that submitted the tax line is liable for remitting. A value of null indicates unknown liability for this tax line.
RatePercentageDoubleFalseNoThe proportion of the line item price that the tax represents as a percentage.
PriceSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
PriceSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
PriceSetShopMoneyAmountDecimalFalseNoDecimal money amount.
PriceSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoThe unique identifier of the line item.
FulfillmentOrderIdStringFalseNoThe unique identifier of the fulfillment order.
ImageIdStringFalseNoA unique ID for the image.
ImageWidthIntFalseNoThe original width of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
ImageAltTextStringFalseNoA word or phrase to share the nature or contents of an image.
ImageHeightIntFalseNoThe original height of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
ImageUrlStringFalseNoThe location of the image as a URL.
InventoryItemIdStringFalseNoThe ID of the inventory item.
SkuStringFalseNoThe variant SKU number.
ProductTitleStringFalseNoThe title of the product.
VariantTitleStringFalseNoThe name of the variant.
VendorStringFalseNoThe name of the vendor who made the variant.
RemainingQuantityIntFalseNoThe number of units remaining to be fulfilled.
TotalQuantityIntFalseNoThe total number of units to be fulfilled.
RequiresShippingBoolFalseNoWhether physical shipping is required for the variant.
WeightUnitStringFalseNoThe weight of a line item unit. The unit of measurement for value.
WeightValueDoubleFalseNoThe weight value using the unit system specified with unit.
WarningsStringFalseNoWarning messages for a fulfillment order line item.
FinancialSummariesStringFalseNoThe financial summary for the Fulfillment Order's Line Items.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoThe unique identifier of the line item.
FulfillmentOrderIdStringFalseNoThe unique identifier of the fulfillment order.
ImageIdStringFalseNoA unique ID for the image.
ImageWidthIntFalseNoThe original width of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
ImageAltTextStringFalseNoA word or phrase to share the nature or contents of an image.
ImageHeightIntFalseNoThe original height of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
ImageUrlStringFalseNoThe location of the image as a URL.
InventoryItemIdStringFalseNoThe ID of the inventory item.
SkuStringFalseNoThe variant SKU number.
ProductTitleStringFalseNoThe title of the product.
VariantTitleStringFalseNoThe name of the variant.
VendorStringFalseNoThe name of the vendor who made the variant.
RemainingQuantityIntFalseNoThe number of units remaining to be fulfilled.
TotalQuantityIntFalseNoThe total number of units to be fulfilled.
RequiresShippingBoolFalseNoWhether physical shipping is required for the variant.
WeightUnitStringFalseNoThe weight of a line item unit. The unit of measurement for value.
WeightValueDoubleFalseNoThe weight value using the unit system specified with unit.
WarningsStringFalseNoWarning messages for a fulfillment order line item.
FinancialSummariesStringFalseNoThe financial summary for the Fulfillment Order's Line Items.
LocationId [KEY]StringFalseNoThe unique identifier of the location.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoThe unique identifier of the line item.
FulfillmentOrderIdStringFalseNoThe unique identifier of the fulfillment order.
ImageIdStringFalseNoA unique ID for the image.
ImageWidthIntFalseNoThe original width of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
ImageAltTextStringFalseNoA word or phrase to share the nature or contents of an image.
ImageHeightIntFalseNoThe original height of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
ImageUrlStringFalseNoThe location of the image as a URL.
InventoryItemIdStringFalseNoThe ID of the inventory item.
SkuStringFalseNoThe variant SKU number.
ProductTitleStringFalseNoThe title of the product.
VariantTitleStringFalseNoThe name of the variant.
VendorStringFalseNoThe name of the vendor who made the variant.
RemainingQuantityIntFalseNoThe number of units remaining to be fulfilled.
TotalQuantityIntFalseNoThe total number of units to be fulfilled.
RequiresShippingBoolFalseNoWhether physical shipping is required for the variant.
WeightUnitStringFalseNoThe weight of a line item unit. The unit of measurement for value.
WeightValueDoubleFalseNoThe weight value using the unit system specified with unit.
WarningsStringFalseNoWarning messages for a fulfillment order line item.
FinancialSummariesStringFalseNoThe financial summary for the Fulfillment Order's Line Items.
LocationId [KEY]StringFalseNoThe unique identifier of the location.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
FulfillmentOrderId [KEY]StringFalseNoThe unique identifier of the fulfillment order.
LocationId [KEY]StringFalseNoThe unique identifier of the location.
AvailableLineItemsCountIntFalseNoTotal number of fulfillment order line items that can be moved from their current assigned location to the given location.
AvailableLineItemsCountPrecisionStringFalseNoThe count's precision, or the exactness of the value.
UnavailableLineItemsCountIntFalseNoTotal number of fulfillment order line items that can't be moved from their current assigned location to the given location.
UnavailableLineItemsCountPrecisionStringFalseNoThe count's precision, or the exactness of the value.
MovableBoolFalseNoWhether the fulfillment order can be moved to the location.
MessageStringFalseNoA human-readable string with the reason why the fulfillment order, or some of its line items, can't be moved to the location.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
StatusStringFalseNoThe status of the fulfillment order.
FulfillAtDatetimeTrueNoThe date and time at which the fulfillment order will be fulfillable. When this date and time is reached, the scheduled fulfillment order is automatically transitioned to open. For example, the 'fulfill_at' date for a subscription order might be the 1st of each month, a pre-order 'fulfill_at' date would be 'nil', and a standard order 'fulfill_at' date would be the order creation date.
FulfillByDatetimeTrueNoThe latest date and time by which all items in the fulfillment order need to be fulfilled.
OrderNameStringTrueNoThe unique identifier for the order that appears on the order page.
RequestStatusStringTrueNoThe request status of the fulfillment order.
CreatedAtDatetimeTrueNoDate and time when the fulfillment order was created.
UpdatedAtDatetimeTrueNoThe date and time when the fulfillment order was last updated.
OrderProcessedAtDatetimeTrueNoThe date and time when the fulfillment order was processed at.
AssignedLocationNameStringTrueNoThe name of the location.
AssignedLocationAddress1StringTrueNoThe first line of the address for the location.
AssignedLocationAddress2StringTrueNoThe second line of the address for the location.
AssignedLocationCityStringTrueNoThe city of the location.
AssignedLocationPhoneStringTrueNoThe phone number of the location.
AssignedLocationProvinceStringTrueNoThe province of the location.
AssignedLocationZipStringTrueNoThe ZIP code of the location.
AssignedLocationCountryCodeStringTrueNoThe two-letter country code of the location.
AssignedLocationLocationIdStringTrueNoA globally-unique ID.
AssignedLocationLocationLegacyResourceIdStringTrueNoThe ID of the corresponding resource in the REST Admin API.
AssignedLocationLocationNameStringTrueNoThe name of the location.
AssignedLocationLocationActivatableBoolTrueNoWhether this location can be reactivated.
AssignedLocationLocationDeactivatableBoolTrueNoWhether this location can be deactivated.
AssignedLocationLocationDeletableBoolTrueNoWhether this location can be deleted.
AssignedLocationLocationAddressVerifiedBoolTrueNoWhether the location address has been verified.
AssignedLocationLocationDeactivatedAtStringTrueNoThe date and time that the location was deactivated at. For example, 3: 30 pm on September 7, 2019 in the time zone of UTC (Universal Time Coordinated) is represented as '2019-09-07T15: 50: 00Z'.
AssignedLocationLocationIsActiveBoolTrueNoWhether the location is active.
AssignedLocationLocationShipsInventoryBoolTrueNoWhether this location is used for calculating shipping rates. In multi-origin shipping mode, this flag is ignored.
AssignedLocationLocationFulfillsOnlineOrdersBoolTrueNoWhether this location can fulfill online orders.
AssignedLocationLocationHasActiveInventoryBoolTrueNoWhether this location has active inventory.
AssignedLocationLocationHasUnfulfilledOrdersBoolTrueNoWhether this location has orders that need to be fulfilled.
DeliveryMethodIdStringTrueNoA globally-unique ID.
DeliveryMethodMethodTypeStringTrueNoThe type of the delivery method.
DeliveryMethodMaxDeliveryDateTimeDatetimeTrueNoThe latest delivery date and time when the fulfillment is expected to arrive at the buyer's location.
DeliveryMethodMinDeliveryDateTimeDatetimeTrueNoThe earliest delivery date and time when the fulfillment is expected to arrive at the buyer's location.
DeliveryMethodServiceCodeStringTrueNoA reference to the shipping method.
DeliveryMethodSourceReferenceStringTrueNoPromise provider specific data associated with delivery promise.
DeliveryMethodBrandedPromiseNameStringTrueNoThe name of the branded promise. For example: 'Shop Promise'.
DeliveryMethodBrandedPromiseHandleStringTrueNoThe handle of the branded promise. For example: 'shop_promise'.
DeliveryMethodAdditionalInformationPhoneStringTrueNoThe phone number to contact when performing the delivery.
DeliveryMethodAdditionalInformationInstructionsStringTrueNoThe delivery instructions to follow when performing the delivery.
DestinationIdStringTrueNoA globally-unique ID.
DestinationFirstNameStringTrueNoThe first name of the customer at the destination.
DestinationLastNameStringTrueNoThe last name of the customer at the destination.
DestinationAddress1StringTrueNoThe first line of the address of the destination.
DestinationAddress2StringTrueNoThe second line of the address of the destination.
DestinationCityStringTrueNoThe city of the destination.
DestinationCompanyStringTrueNoThe company of the destination.
DestinationEmailStringTrueNoThe email of the customer at the destination.
DestinationPhoneStringTrueNoThe phone number of the customer at the destination.
DestinationProvinceStringTrueNoThe province of the destination.
DestinationZipStringTrueNoThe ZIP code of the destination.
DestinationCountryCodeStringTrueNoThe two-letter country code of the destination.
InternationalDutiesIncotermStringTrueNoThe method of duties payment. Example values: 'DDP', 'DAP'.
OrderIdStringTrueNoA globally-unique ID.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
LegacyResourceIdStringTrueNoThe ID of the corresponding resource in the REST Admin API.
OrderIdStringTrueNoGlobally unique identifier.
NameStringTrueNoHuman readable reference identifier for this fulfillment.
StatusStringTrueNoThe status of the fulfillment.
DeliveredAtDatetimeTrueNoThe date that this fulfillment was delivered.
DisplayStatusStringTrueNoHuman readable display status for this fulfillment.
RequiresShippingBoolTrueNoWhether any of the line items in the fulfillment require shipping.
TotalQuantityIntTrueNoSum of all line item quantities for the fulfillment.
EstimatedDeliveryAtDatetimeTrueNoThe estimated date that this fulfillment will arrive.
InTransitAtDatetimeTrueNoThe date and time when the fulfillment went into transit.
CreatedAtDatetimeTrueNoThe date and time when the fulfillment was created.
UpdatedAtDatetimeTrueNoThe date and time when the fulfillment was last modified.
LocationIdStringTrueNoA globally-unique ID.
ServiceIdStringTrueNoThe ID of the fulfillment service.
OriginAddressAddress1StringTrueNoThe street address of the fulfillment location.
OriginAddressAddress2StringTrueNoThe second line of the address. Typically the number of the apartment, suite, or unit.
OriginAddressCityStringTrueNoThe city in which the fulfillment location is located.
OriginAddressCountryCodeStringTrueNoThe country code of the fulfillment location.
OriginAddressProvinceCodeStringTrueNoThe province code of the fulfillment location.
OriginAddressZipStringTrueNoThe zip code of the fulfillment location.
TrackingInfoNumberStringTrueNoTrackingInfoNumber
TrackingInfoUrlStringTrueNoTrackingInfoUrl
FulfillmentOrderIdsStringFalseYesAn aggregated object containing the FulfillmentOrder ids. Ex: [{'fulfillmentOrderId': 'gid://shopify/FulfillmentOrder/xxx'}]

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoThe ID of the fulfillment service.
ServiceNameStringFalseNoThe name of the fulfillment service as seen by merchants.
HandleStringTrueNoHuman-readable unique identifier for this fulfillment service.
TypeStringTrueNoType associated with the fulfillment service.
CallbackUrlStringFalseNoThe callback URL the fulfillment service has registered for requests.
InventoryManagementBoolFalseNoWhether the fulfillment service tracks product inventory and provides updates to Shopify.
PermitsSkuSharingBoolTrueNoWhether the fulfillment service can stock inventory alongside other locations.
LocationIdStringTrueNoGlobally unique identifier.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
FulfillmentIdStringFalseFulfillments.IdNoThe ID of the Fulfillment to return.
CompanyStringFalseNoThe name of the tracking company.
NumberStringFalseNoThe tracking number of the fulfillment.
UrlStringFalseNoThe URLs to track the fulfillment.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
EnabledBoolTrueNoWhether the gift card is enabled.
NoteStringFalseNoThe note associated with the gift card, which is not visible to the customer.
DisabledAtDatetimeTrueNoThe date and time at which the gift card was disabled.
ExpiresOnDateFalseNoThe date at which the gift card will expire.
LastCharactersStringTrueNoThe final four characters of the gift card code.
MaskedCodeStringTrueNoThe gift card code. Everything but the final four characters is masked.
CreatedAtDatetimeTrueNoThe date and time at which the gift card was created.
BalanceAmountDecimalTrueNoDecimal money amount.
BalanceCurrencyCodeStringTrueNoCurrency of the money.
InitialValueAmountDecimalTrueNoDecimal money amount.
InitialValueCurrencyCodeStringTrueNoCurrency of the money.
CustomerIdStringFalseNoA globally-unique ID.
OrderIdStringTrueNoA globally-unique ID.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
InventoryItemIdStringFalseInventoryItems.IdNoA globally-unique ID.
CountryCodeStringFalseNoThe ISO 3166-1 alpha-2 country code for the country that issued the specified harmonized system code.
HarmonizedSystemCode [KEY]StringFalseNoThe country-specific harmonized system code. These are usually longer than 6 digits.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
InventoryLevelIdStringFalseInventoryItemInventoryLevels.IdNoA globally-unique ID.
InventoryLevelLocationIdStringFalseNoA globally-unique ID.
NameStringFalseNoThe name that identifies the inventory quantity.
QuantityIntFalseNoThe quantity for the quantity name.
UpdatedAtDatetimeFalseNoWhen the quantity was last updated.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
InventoryItemIdStringFalseInventoryItems.IdNoA globally-unique ID.
LocationIdStringFalseNoA globally-unique ID.
CanDeactivateBoolFalseNoWhether the inventory items associated with the inventory level can be deactivated.
DeactivationAlertStringFalseNoDescribes either the impact of deactivating the inventory level, or why the inventory level can't be deactivated.
CreatedAtDatetimeFalseNoThe date and time when the inventory level was created.
UpdatedAtDatetimeFalseNoThe date and time when the inventory level was updated.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
LegacyResourceIdStringTrueNoThe ID of the corresponding resource in the REST Admin API.
VariantIdStringTrueNoA globally-unique ID.
SkuStringFalseNoInventory item SKU.
TrackedBoolFalseNoWhether inventory levels are tracked for the item.
LocationsCountIntTrueNoThe number of locations where this inventory item is stocked.
LocationsCountPrecisionStringTrueNoThe count's precision, or the exactness of the value.
RequiresShippingBoolFalseNoWhether the inventory item requires shipping.
DuplicateSkuCountIntTrueNoThe number of inventory items that share the same SKU with this item.
HarmonizedSystemCodeStringFalseNoThe harmonized system code of the item.
InventoryHistoryUrlStringTrueNoThe URL that points to the inventory history for the item.
CountryCodeOfOriginStringFalseNoThe ISO 3166-1 alpha-2 country code of where the item originated from.
ProvinceCodeOfOriginStringFalseNoThe ISO 3166-2 alpha-2 province code of where the item originated from.
CreatedAtDatetimeTrueNoThe date and time when the inventory item was created.
UpdatedAtDatetimeTrueNoThe date and time when the inventory item was updated.
TrackedEditableLockedBoolTrueNoWhether the attribute is locked for editing.
TrackedEditableReasonStringTrueNoThe reason the attribute is locked for editing.
MeasurementIdStringTrueNoA globally-unique ID.
MeasurementWeightValueDoubleFalseNoThe weight value using the unit system specified with 'unit'.
MeasurementWeightUnitStringFalseNoThe unit of measurement for 'value'.
UnitCostAmountDecimalFalseNoDecimal money amount.
UnitCostCurrencyCodeStringTrueNoCurrency of the money.
InventoryItemCountryHarmonizedSystemCodesStringFalseNoList of country-specific harmonized system codes.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID that's returned when running an asynchronous mutation.
DoneBoolFalseNoThis indicates if the job is still queued or has been run.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
LegacyResourceIdStringTrueNoThe ID of the corresponding resource in the REST Admin API.
NameStringFalseNoThe name of the location.
ActivatableBoolTrueNoWhether this location can be reactivated.
DeactivatableBoolTrueNoWhether this location can be deactivated.
DeletableBoolTrueNoWhether this location can be deleted.
AddressVerifiedBoolTrueNoWhether the location address has been verified.
DeactivatedAtStringTrueNoThe date and time that the location was deactivated at. For example, 3: 30 pm on September 7, 2019 in the time zone of UTC (Universal Time Coordinated) is represented as '2019-09-07T15: 50: 00Z'.
IsActiveBoolFalseNoWhether the location is active.
ShipsInventoryBoolTrueNoWhether this location is used for calculating shipping rates. In multi-origin shipping mode, this flag is ignored.
IsFulfillmentServiceBoolTrueNoWhether this location is a fulfillment service.
FulfillsOnlineOrdersBoolFalseNoWhether this location can fulfill online orders.
HasActiveInventoryBoolTrueNoWhether this location has active inventory.
HasUnfulfilledOrdersBoolTrueNoWhether this location has orders that need to be fulfilled.
CreatedAtDatetimeTrueNoThe date and time that the location was added to a shop.
UpdatedAtDatetimeTrueNoThe date and time when the location was last updated.
AddressAddress1StringFalseNoThe first line of the address for the location.
AddressAddress2StringFalseNoThe second line of the address for the location.
AddressCityStringFalseNoThe city of the location.
AddressCountryStringTrueNoThe country of the location.
AddressFormattedStringTrueNoA formatted version of the address for the location.
AddressLatitudeDoubleTrueNoThe latitude coordinates of the location.
AddressLongitudeDoubleTrueNoThe longitude coordinates of the location.
AddressPhoneStringFalseNoThe phone number of the location.
AddressProvinceStringTrueNoThe province of the location.
AddressZipStringFalseNoThe ZIP code of the location.
AddressCountryCodeStringFalseNoThe country code of the location.
AddressProvinceCodeStringFalseNoThe code for the province, state, or district of the address of the location.
FulfillmentServiceIdStringTrueNoThe ID of the fulfillment service.
LocalPickupSettingsV2InstructionsStringTrueNoAdditional instructions or information related to the local pickup.
LocalPickupSettingsV2PickupTimeStringTrueNoThe estimated pickup time to show customers at checkout.
IncludeInactiveBoolTrueNoIf true, also include the locations that are deactivated.
IncludeLegacyBoolTrueNoIf true, also include the legacy locations of fulfillment services.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
RemoteIdStringFalseNoAn optional ID that helps Shopify validate engagement data.
LegacyResourceIdStringFalseNoThe ID of the corresponding resource in the REST Admin API.
AppIdStringFalseNoA globally-unique ID.
MarketingChannelTypeStringFalseNoThe medium through which the marketing activity and event reached consumers. This is used for reporting aggregation.
DescriptionStringFalseNoA human-readable description of the marketing event.
TypeStringFalseNoThe marketing event type.
EndedAtDatetimeFalseNoThe date and time when the marketing event ended.
ManageUrlStringFalseNoThe URL where the marketing event can be managed.
PreviewUrlStringFalseNoThe URL where the marketing event can be previewed.
StartedAtDatetimeFalseNoThe date and time when the marketing event started.
UtmCampaignStringFalseNoThe name of the marketing campaign.
UtmMediumStringFalseNoThe medium that the marketing campaign is using. Example values: 'cpc', 'banner'.
UtmSourceStringFalseNoThe referrer of the marketing event. Example values: 'google', 'newsletter'.
SourceAndMediumStringFalseNoWhere the 'MarketingEvent' occurred and what kind of content was used. Because 'utmSource' and 'utmMedium' are often used interchangeably, this is based on a combination of 'marketingChannel', 'referringDomain', and 'type' to provide a consistent representation for any given piece of marketing regardless of the app that created it.
ScheduledToEndAtDatetimeFalseNoThe date and time when the marketing event is scheduled to end.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoThe unique ID of the metafield.
LegacyResourceIdLongTrueNoThe ID of the corresponding resource in the REST Admin API.
NamespaceStringTrueNoA container for a set of metafields. You need to define a custom namespace for your metafields to distinguish them from the metafields used by other apps.
KeyStringTrueNoThe name of the metafield.
ValueStringTrueNoThe information to be stored as metadata.
TypeStringTrueNoThe metafield's information type.
DescriptionStringTrueNoA description of the information that the metafield contains.
OwnerIdStringTrueNoThe ID of the resource that the metafield is attached to.
OwnerResourceStringTrueNoThe type of resource that the metafield is attached to.
CreatedAtDatetimeTrueNoThe date and time when the metafield was created.
UpdatedAtDatetimeTrueNoThe date and time when the metafield was last updated.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
IDStringFalseNoA globally-unique ID.
NameStringFalseNoThe human-readable name.
MetaobjectsCountIntFalseNoThe count of metaobjects created for the definition.
TypeStringFalseNoThe type of the object definition. Defines the namespace of associated metafields.
DescriptionStringFalseNoThe administrative description.
DisplayNameKeyStringFalseNoThe key of a field to reference as the display name for each object.
AccessAdminStringFalseNoAccess configuration for the metaobject definition. Access configuration for Admin API surface areas, including the GraphQL Admin API.
AccessStorefrontStringFalseNoAccess configuration for the metaobject definition. Access configuration for Storefront surface areas, including the GraphQL Storefront API and Liquid.
CapabilitiesPublishableEnabledBoolFalseNoThe capabilities of the metaobject definition. Indicate whether a metaobject definition is publishable. Indicates if the capability is enabled.
CapabilitiesTranslatableEnabledBoolFalseNoThe capabilities of the metaobject definition. Indicate whether a metaobject definition is translatable. Indicates if the capability is enabled.
CapabilitiesOnlineStoreEnabledBoolFalseNoThe capabilities of the metaobject definition. Indicates whether a metaobject definition can be displayed as a page on the Online Store. Indicates if the capability is enabled.
CapabilitiesOnlineStoreDataCanCreateRedirectsBoolFalseNoThe capabilities of the metaobject definition. Indicates whether a metaobject definition can be displayed as a page on the Online Store. The data associated with the Online Store capability. Flag indicating if a sufficient number of redirects are available to redirect all published entries.
CapabilitiesOnlineStoreDataUrlHandleStringFalseNoThe capabilities of the metaobject definition. Indicates whether a metaobject definition can be displayed as a page on the Online Store. The data associated with the Online Store capability. The URL handle for accessing pages of this metaobject type in the Online Store.
CapabilitiesRenderableEnabledBoolFalseNoThe capabilities of the metaobject definition. Indicate whether a metaobject definition is renderable and exposes SEO data. Indicates if the capability is enabled.
CapabilitiesRenderableDataMetaDescriptionKeyStringFalseNoThe capabilities of the metaobject definition. Indicate whether a metaobject definition is renderable and exposes SEO data. The data associated with the renderable capability. The metaobject field used as an alias for the SEO page description.
CapabilitiesRenderableDataMetaTitleKeyStringFalseNoThe capabilities of the metaobject definition. Indicate whether a metaobject definition is renderable and exposes SEO data. The data associated with the renderable capability. The metaobject field used as an alias for the SEO page title.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
ID [KEY]StringFalseNoA globally-unique ID.
HandleStringFalseNoThe unique handle of the object, useful as a custom ID.
DisplayNameStringFalseNoThe preferred display name field value of the metaobject.
CreatedByDeveloperNameStringFalseNoThe name of the app developer.
DefinitionIdStringFalseNoThe identifier of the MetaobjectDefinition that models this object type.
TitleStringFalseNoName of the app.
TypeStringFalseNoThe type of the metaobject.
Key [KEY]StringFalseNoThe object key of this field.
ValueStringFalseNoThe assigned field value, always stored as a string regardless of the field type.
TypeFieldStringFalseNoThe type of the field.
UpdatedAtDatetimeFalseNoWhen the object was last updated.
CapabilitiesPublishableStatusStringFalseNoMetaobject capabilities for this Metaobject. The publishable capability for this metaobject.
CapabilitiesOnlineStoreTemplateSuffixStringFalseNoMetaobject capabilities for this Metaobject. The Online Store capability for this metaobject. The theme template used when viewing the metaobject in a store.
ThumbnailFieldKeyStringFalseNoThe recommended field to visually represent this metaobject. May be a file reference or color field. The object key of this field.
ThumbnailFieldThumbnailHexStringFalseNoThe recommended field to visually represent this metaobject. May be a file reference or color field. The hexadecimal color code to be used for respresenting this metaobject.
ThumbnailFieldFileIdStringFalseNoThe recommended field to visually represent this metaobject. May be a file reference or color field. The file to be used for visual representation of this metaobject. A globally-unique ID.
ThumbnailFieldFileAltStringFalseNoThe recommended field to visually represent this metaobject. May be a file reference or color field. The file to be used for visual representation of this metaobject. A word or phrase to describe the contents or the function of a file.
ThumbnailFieldFileCreatedAtDatetimeFalseNoThe recommended field to visually represent this metaobject. May be a file reference or color field. The file to be used for visual representation of this metaobject. The date and time when the file was created.
ThumbnailFieldFileUpdatedAtDatetimeFalseNoThe recommended field to visually represent this metaobject. May be a file reference or color field. The file to be used for visual representation of this metaobject. The date and time when the file was last updated.
ThumbnailFieldFileFileStatusStringFalseNoThe recommended field to visually represent this metaobject. May be a file reference or color field. The file to be used for visual representation of this metaobject. The status of the file.
ThumbnailFieldFileFileErrorsStringFalseNoThe recommended field to visually represent this metaobject. May be a file reference or color field. The file to be used for visual representation of this metaobject. Any errors that have occurred on the file.
ThumbnailFieldFilePreviewStatusStringFalseNoThe recommended field to visually represent this metaobject. May be a file reference or color field. The file to be used for visual representation of this metaobject. The preview image for the media. Current status of the preview image.
ThumbnailFieldFilePreviewImageIdStringFalseNoThe recommended field to visually represent this metaobject. May be a file reference or color field. The file to be used for visual representation of this metaobject. The preview image for the media. A unique ID for the image.
ThumbnailFieldFilePreviewImageAltTextStringFalseNoThe recommended field to visually represent this metaobject. May be a file reference or color field. The file to be used for visual representation of this metaobject. The preview image for the media. A word or phrase to share the nature or contents of an image.
ThumbnailFieldFilePreviewImageHeightIntFalseNoThe recommended field to visually represent this metaobject. May be a file reference or color field. The file to be used for visual representation of this metaobject. The preview image for the media. The original height of the image in pixels. Returns null if the image isn't hosted by Shopify.
ThumbnailFieldFilePreviewImageWidthIntFalseNoThe recommended field to visually represent this metaobject. May be a file reference or color field. The file to be used for visual representation of this metaobject. The preview image for the media. The original width of the image in pixels. Returns null if the image isn't hosted by Shopify.
ThumbnailFieldFilePreviewImageUrlStringFalseNoThe recommended field to visually represent this metaobject. May be a file reference or color field. The file to be used for visual representation of this metaobject. The preview image for the media. The location of the image as a URL.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
OrderIdStringFalseOrders.IdNoA globally-unique ID.
NameStringFalseNoThe name of the additional fee.
PricePresentmentMoneyAmountDecimalFalseNoDecimal money amount.
PricePresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
PriceShopMoneyAmountDecimalFalseNoDecimal money amount.
PriceShopMoneyCurrencyCodeStringFalseNoCurrency of the money.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
OrderIdStringFalseOrders.IdNoThe parent resource of the agreement.
AgreementIdStringFalseNoThe unique ID for the agreement.
Id [KEY]StringFalseNoThe unique ID for the sale.
ActionTypeStringFalseNoThe type of order action that the sale represents.
LineTypeStringFalseNoThe line type associated with the sale.
QuantityIntFalseNoThe number of units either ordered or intended to be returned.
TotalAmountPresentmentMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Decimal money amount.
TotalAmountPresentmentCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Currency of the money.
TotalAmountShopMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Decimal money amount.
TotalAmountShopMoneyCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Currency of the money.
TotalTaxAmountPresentmentMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Decimal money amount.
TotalTaxAmountPresentmentCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Currency of the money.
TotalTaxAmountShopMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in shop currency. Decimal money amount.
TotalTaxAmountShopMoneyCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in shop currency. Currency of the money.
TotalDiscountAmountBeforeTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountBeforeTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Currency of the money.
TotalDiscountAmountAfterTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountAfterTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountAfterTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountAfterTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Currency of the money.
TaxesStringFalseNoThe individual taxes associated with the sale.
AdditionalFeeSaleAdditionalFeeIdStringFalseNoA sale associated with an additional fee charge. The additional fees for the associated sale. A globally-unique ID.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
OrderIdStringFalseOrders.IdNoThe parent resource of the agreement.
AgreementIdStringFalseNoThe unique ID for the agreement.
Id [KEY]StringFalseNoThe unique ID for the sale.
ActionTypeStringFalseNoThe type of order action that the sale represents.
LineTypeStringFalseNoThe line type associated with the sale.
QuantityIntFalseNoThe number of units either ordered or intended to be returned.
TotalAmountPresentmentMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Decimal money amount.
TotalAmountPresentmentCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Currency of the money.
TotalAmountShopMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Decimal money amount.
TotalAmountShopMoneyCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Currency of the money.
TotalTaxAmountPresentmentMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Decimal money amount.
TotalTaxAmountPresentmentCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Currency of the money.
TotalTaxAmountShopMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in shop currency. Decimal money amount.
TotalTaxAmountShopMoneyCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in shop currency. Currency of the money.
TotalDiscountAmountBeforeTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountBeforeTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Currency of the money.
TotalDiscountAmountAfterTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountAfterTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountAfterTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountAfterTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Currency of the money.
TaxesStringFalseNoThe individual taxes associated with the sale.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
OrderIdStringFalseOrders.IdNoThe parent resource of the agreement.
AgreementIdStringFalseNoThe unique ID for the agreement.
Id [KEY]StringFalseNoThe unique ID for the sale.
ActionTypeStringFalseNoThe type of order action that the sale represents.
LineTypeStringFalseNoThe line type associated with the sale.
QuantityIntFalseNoThe number of units either ordered or intended to be returned.
TotalAmountPresentmentMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Decimal money amount.
TotalAmountPresentmentCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Currency of the money.
TotalAmountShopMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Decimal money amount.
TotalAmountShopMoneyCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Currency of the money.
TotalTaxAmountPresentmentMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Decimal money amount.
TotalTaxAmountPresentmentCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Currency of the money.
TotalTaxAmountShopMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in shop currency. Decimal money amount.
TotalTaxAmountShopMoneyCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in shop currency. Currency of the money.
TotalDiscountAmountBeforeTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountBeforeTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Currency of the money.
TotalDiscountAmountAfterTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountAfterTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountAfterTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountAfterTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Currency of the money.
TaxesStringFalseNoThe individual taxes associated with the sale.
DutySaleDutyIdStringFalseNoA sale associated with a duty charge. The duty for the associated sale. A globally-unique ID.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
OrderIdStringFalseOrders.IdNoThe parent resource of the agreement.
AgreementIdStringFalseNoThe unique ID for the agreement.
Id [KEY]StringFalseNoThe unique ID for the sale.
ActionTypeStringFalseNoThe type of order action that the sale represents.
LineTypeStringFalseNoThe line type associated with the sale.
QuantityIntFalseNoThe number of units either ordered or intended to be returned.
TotalAmountPresentmentMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Decimal money amount.
TotalAmountPresentmentCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Currency of the money.
TotalAmountShopMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Decimal money amount.
TotalAmountShopMoneyCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Currency of the money.
TotalTaxAmountPresentmentMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Decimal money amount.
TotalTaxAmountPresentmentCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Currency of the money.
TotalTaxAmountShopMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in shop currency. Decimal money amount.
TotalTaxAmountShopMoneyCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in shop currency. Currency of the money.
TotalDiscountAmountBeforeTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountBeforeTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Currency of the money.
TotalDiscountAmountAfterTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountAfterTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountAfterTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountAfterTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Currency of the money.
TaxesStringFalseNoThe individual taxes associated with the sale.
GiftCardSaleLineItemIdStringFalseNoA sale associated with a gift card. The line item for the associated sale. A globally-unique ID.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
OrderIdStringFalseOrders.IdNoThe parent resource of the agreement.
AgreementIdStringFalseNoThe unique ID for the agreement.
Id [KEY]StringFalseNoThe unique ID for the sale.
ActionTypeStringFalseNoThe type of order action that the sale represents.
LineTypeStringFalseNoThe line type associated with the sale.
QuantityIntFalseNoThe number of units either ordered or intended to be returned.
TotalAmountPresentmentMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Decimal money amount.
TotalAmountPresentmentCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Currency of the money.
TotalAmountShopMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Decimal money amount.
TotalAmountShopMoneyCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Currency of the money.
TotalTaxAmountPresentmentMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Decimal money amount.
TotalTaxAmountPresentmentCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Currency of the money.
TotalTaxAmountShopMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in shop currency. Decimal money amount.
TotalTaxAmountShopMoneyCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in shop currency. Currency of the money.
TotalDiscountAmountBeforeTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountBeforeTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Currency of the money.
TotalDiscountAmountAfterTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountAfterTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountAfterTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountAfterTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Currency of the money.
TaxesStringFalseNoThe individual taxes associated with the sale.
ProductSaleLineItemIdStringFalseNoA sale associated with a product. The line item for the associated sale. A globally-unique ID.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
OrderIdStringFalseOrders.IdNoThe parent resource of the agreement.
Id [KEY]StringFalseNoThe unique ID for the agreement.
HappenedAtDatetimeFalseNoThe date and time at which the agreement occurred.
ReasonStringFalseNoThe reason the agreement was created.
UserIdStringFalseNoThe staff member associated with the agreement. A globally-unique ID.(This column is available only with a ShopifyPlus subscription)
AppApiKeyStringFalseNoThe application that created the agreement. A unique application API identifier.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
OrderIdStringFalseOrders.IdNoThe parent resource of the agreement.
AgreementIdStringFalseNoThe unique ID for the agreement.
Id [KEY]StringFalseNoThe unique ID for the sale.
ActionTypeStringFalseNoThe type of order action that the sale represents.
LineTypeStringFalseNoThe line type associated with the sale.
QuantityIntFalseNoThe number of units either ordered or intended to be returned.
TotalAmountPresentmentMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Decimal money amount.
TotalAmountPresentmentCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Currency of the money.
TotalAmountShopMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Decimal money amount.
TotalAmountShopMoneyCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Currency of the money.
TotalTaxAmountPresentmentMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Decimal money amount.
TotalTaxAmountPresentmentCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Currency of the money.
TotalTaxAmountShopMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in shop currency. Decimal money amount.
TotalTaxAmountShopMoneyCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in shop currency. Currency of the money.
TotalDiscountAmountBeforeTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountBeforeTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Currency of the money.
TotalDiscountAmountAfterTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountAfterTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountAfterTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountAfterTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Currency of the money.
TaxesStringFalseNoThe individual taxes associated with the sale.
ShippingLineSaleShippingLineIdStringFalseNoA sale associated with a shipping charge. The shipping line item for the associated sale. shippingLine is not available if the SaleActionType is a return. A globally-unique ID.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
OrderIdStringFalseOrders.IdNoThe parent resource of the agreement.
AgreementIdStringFalseNoThe unique ID for the agreement.
Id [KEY]StringFalseNoThe unique ID for the sale.
ActionTypeStringFalseNoThe type of order action that the sale represents.
LineTypeStringFalseNoThe line type associated with the sale.
QuantityIntFalseNoThe number of units either ordered or intended to be returned.
TotalAmountPresentmentMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Decimal money amount.
TotalAmountPresentmentCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Currency of the money.
TotalAmountShopMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Decimal money amount.
TotalAmountShopMoneyCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Currency of the money.
TotalTaxAmountPresentmentMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Decimal money amount.
TotalTaxAmountPresentmentCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Currency of the money.
TotalTaxAmountShopMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in shop currency. Decimal money amount.
TotalTaxAmountShopMoneyCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in shop currency. Currency of the money.
TotalDiscountAmountBeforeTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountBeforeTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Currency of the money.
TotalDiscountAmountAfterTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountAfterTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountAfterTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountAfterTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Currency of the money.
TaxesStringFalseNoThe individual taxes associated with the sale.
TipSaleLineItemIdStringFalseNoA sale associated with a tip. The line item for the associated sale. A globally-unique ID.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
OrderIdStringFalseOrders.IdNoThe parent resource of the agreement.
AgreementIdStringFalseNoThe unique ID for the agreement.
Id [KEY]StringFalseNoThe unique ID for the sale.
ActionTypeStringFalseNoThe type of order action that the sale represents.
LineTypeStringFalseNoThe line type associated with the sale.
QuantityIntFalseNoThe number of units either ordered or intended to be returned.
TotalAmountPresentmentMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Decimal money amount.
TotalAmountPresentmentCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Currency of the money.
TotalAmountShopMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Decimal money amount.
TotalAmountShopMoneyCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Currency of the money.
TotalTaxAmountPresentmentMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Decimal money amount.
TotalTaxAmountPresentmentCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Currency of the money.
TotalTaxAmountShopMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in shop currency. Decimal money amount.
TotalTaxAmountShopMoneyCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in shop currency. Currency of the money.
TotalDiscountAmountBeforeTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountBeforeTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Currency of the money.
TotalDiscountAmountAfterTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountAfterTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountAfterTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountAfterTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Currency of the money.
TaxesStringFalseNoThe individual taxes associated with the sale.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
ResourceId [KEY]StringFalseOrders.IdNoA globally-unique ID.
Key [KEY]StringFalseNoKey or name of the attribute.
ValueStringFalseNoValue of the attribute.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
OrderId [KEY]StringFalseOrders.IdNoA globally-unique ID.
AllocationMethodStringFalseNoThe method by which the discount's value is applied to its entitled items.
Index [KEY]IntFalseNoAn ordered index that can be used to identify the discount application and indicate the precedence of the discount application for calculations.
TargetSelectionStringFalseNoHow the discount amount is distributed on the discounted lines.
TargetTypeStringFalseNoWhether the discount is applied on line items or shipping lines.
ValueAmountDecimalFalseNoThe value of the discount application. Decimal money amount.
ValueCurrencyCodeStringFalseNoThe value of the discount application. Currency of the money.
ValuePercentageDoubleFalseNoThe value of the discount application. The percentage value of the object. This is a number between -100 (free) and 0 (no discount).
AutomaticDiscountApplicationTitleStringFalseNoThe title of the discount application.
DiscountCodeApplicationCodeStringFalseNoThe string identifying the discount code that was used at the time of application.
ManualDiscountApplicationTitleStringFalseNoThe title of the discount application.
ManualDiscountApplicationDescriptionStringFalseNoThe description of the discount application.
ScriptDiscountApplicationTitleStringFalseNoThe title of the discount application.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
OrderIdStringFalseOrders.IdNoThe parent resource of the agreement.
AgreementIdStringFalseNoThe unique ID for the agreement.
Id [KEY]StringFalseNoThe unique ID for the sale.
ActionTypeStringFalseNoThe type of order action that the sale represents.
LineTypeStringFalseNoThe line type associated with the sale.
QuantityIntFalseNoThe number of units either ordered or intended to be returned.
TotalAmountPresentmentMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Decimal money amount.
TotalAmountPresentmentCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Currency of the money.
TotalAmountShopMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Decimal money amount.
TotalAmountShopMoneyCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Currency of the money.
TotalTaxAmountPresentmentMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Decimal money amount.
TotalTaxAmountPresentmentCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Currency of the money.
TotalTaxAmountShopMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in shop currency. Decimal money amount.
TotalTaxAmountShopMoneyCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in shop currency. Currency of the money.
TotalDiscountAmountBeforeTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountBeforeTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Currency of the money.
TotalDiscountAmountAfterTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountAfterTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountAfterTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountAfterTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Currency of the money.
TaxesStringFalseNoThe individual taxes associated with the sale.
AdditionalFeeSaleAdditionalFeeIdStringFalseNoA sale associated with an additional fee charge. The additional fees for the associated sale. A globally-unique ID.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
OrderIdStringFalseOrders.IdNoThe parent resource of the agreement.
AgreementIdStringFalseNoThe unique ID for the agreement.
Id [KEY]StringFalseNoThe unique ID for the sale.
ActionTypeStringFalseNoThe type of order action that the sale represents.
LineTypeStringFalseNoThe line type associated with the sale.
QuantityIntFalseNoThe number of units either ordered or intended to be returned.
TotalAmountPresentmentMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Decimal money amount.
TotalAmountPresentmentCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Currency of the money.
TotalAmountShopMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Decimal money amount.
TotalAmountShopMoneyCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Currency of the money.
TotalTaxAmountPresentmentMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Decimal money amount.
TotalTaxAmountPresentmentCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Currency of the money.
TotalTaxAmountShopMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in shop currency. Decimal money amount.
TotalTaxAmountShopMoneyCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in shop currency. Currency of the money.
TotalDiscountAmountBeforeTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountBeforeTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Currency of the money.
TotalDiscountAmountAfterTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountAfterTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountAfterTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountAfterTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Currency of the money.
TaxesStringFalseNoThe individual taxes associated with the sale.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
OrderIdStringFalseOrders.IdNoThe parent resource of the agreement.
AgreementIdStringFalseNoThe unique ID for the agreement.
Id [KEY]StringFalseNoThe unique ID for the sale.
ActionTypeStringFalseNoThe type of order action that the sale represents.
LineTypeStringFalseNoThe line type associated with the sale.
QuantityIntFalseNoThe number of units either ordered or intended to be returned.
TotalAmountPresentmentMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Decimal money amount.
TotalAmountPresentmentCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Currency of the money.
TotalAmountShopMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Decimal money amount.
TotalAmountShopMoneyCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Currency of the money.
TotalTaxAmountPresentmentMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Decimal money amount.
TotalTaxAmountPresentmentCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Currency of the money.
TotalTaxAmountShopMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in shop currency. Decimal money amount.
TotalTaxAmountShopMoneyCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in shop currency. Currency of the money.
TotalDiscountAmountBeforeTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountBeforeTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Currency of the money.
TotalDiscountAmountAfterTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountAfterTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountAfterTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountAfterTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Currency of the money.
TaxesStringFalseNoThe individual taxes associated with the sale.
DutySaleDutyIdStringFalseNoA sale associated with a duty charge. The duty for the associated sale. A globally-unique ID.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
OrderIdStringFalseOrders.IdNoThe parent resource of the agreement.
AgreementIdStringFalseNoThe unique ID for the agreement.
Id [KEY]StringFalseNoThe unique ID for the sale.
ActionTypeStringFalseNoThe type of order action that the sale represents.
LineTypeStringFalseNoThe line type associated with the sale.
QuantityIntFalseNoThe number of units either ordered or intended to be returned.
TotalAmountPresentmentMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Decimal money amount.
TotalAmountPresentmentCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Currency of the money.
TotalAmountShopMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Decimal money amount.
TotalAmountShopMoneyCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Currency of the money.
TotalTaxAmountPresentmentMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Decimal money amount.
TotalTaxAmountPresentmentCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Currency of the money.
TotalTaxAmountShopMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in shop currency. Decimal money amount.
TotalTaxAmountShopMoneyCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in shop currency. Currency of the money.
TotalDiscountAmountBeforeTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountBeforeTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Currency of the money.
TotalDiscountAmountAfterTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountAfterTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountAfterTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountAfterTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Currency of the money.
TaxesStringFalseNoThe individual taxes associated with the sale.
GiftCardSaleLineItemIdStringFalseNoA sale associated with a gift card. The line item for the associated sale. A globally-unique ID.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
OrderIdStringFalseOrders.IdNoThe parent resource of the agreement.
AgreementIdStringFalseNoThe unique ID for the agreement.
Id [KEY]StringFalseNoThe unique ID for the sale.
ActionTypeStringFalseNoThe type of order action that the sale represents.
LineTypeStringFalseNoThe line type associated with the sale.
QuantityIntFalseNoThe number of units either ordered or intended to be returned.
TotalAmountPresentmentMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Decimal money amount.
TotalAmountPresentmentCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Currency of the money.
TotalAmountShopMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Decimal money amount.
TotalAmountShopMoneyCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Currency of the money.
TotalTaxAmountPresentmentMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Decimal money amount.
TotalTaxAmountPresentmentCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Currency of the money.
TotalTaxAmountShopMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in shop currency. Decimal money amount.
TotalTaxAmountShopMoneyCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in shop currency. Currency of the money.
TotalDiscountAmountBeforeTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountBeforeTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Currency of the money.
TotalDiscountAmountAfterTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountAfterTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountAfterTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountAfterTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Currency of the money.
TaxesStringFalseNoThe individual taxes associated with the sale.
ProductSaleLineItemIdStringFalseNoA sale associated with a product. The line item for the associated sale. A globally-unique ID.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
OrderIdStringFalseOrders.IdNoThe parent resource of the agreement.
Id [KEY]StringFalseNoThe unique ID for the agreement.
HappenedAtDatetimeFalseNoThe date and time at which the agreement occurred.
ReasonStringFalseNoThe reason the agreement was created.
UserIdStringFalseNoThe staff member associated with the agreement. A globally-unique ID.(This column is available only with a ShopifyPlus subscription)
AppApiKeyStringFalseNoThe application that created the agreement. A unique application API identifier.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
OrderIdStringFalseOrders.IdNoThe parent resource of the agreement.
AgreementIdStringFalseNoThe unique ID for the agreement.
Id [KEY]StringFalseNoThe unique ID for the sale.
ActionTypeStringFalseNoThe type of order action that the sale represents.
LineTypeStringFalseNoThe line type associated with the sale.
QuantityIntFalseNoThe number of units either ordered or intended to be returned.
TotalAmountPresentmentMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Decimal money amount.
TotalAmountPresentmentCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Currency of the money.
TotalAmountShopMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Decimal money amount.
TotalAmountShopMoneyCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Currency of the money.
TotalTaxAmountPresentmentMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Decimal money amount.
TotalTaxAmountPresentmentCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Currency of the money.
TotalTaxAmountShopMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in shop currency. Decimal money amount.
TotalTaxAmountShopMoneyCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in shop currency. Currency of the money.
TotalDiscountAmountBeforeTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountBeforeTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Currency of the money.
TotalDiscountAmountAfterTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountAfterTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountAfterTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountAfterTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Currency of the money.
TaxesStringFalseNoThe individual taxes associated with the sale.
ShippingLineSaleShippingLineIdStringFalseNoA sale associated with a shipping charge. The shipping line item for the associated sale. shippingLine is not available if the SaleActionType is a return. A globally-unique ID.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
OrderIdStringFalseOrders.IdNoThe parent resource of the agreement.
AgreementIdStringFalseNoThe unique ID for the agreement.
Id [KEY]StringFalseNoThe unique ID for the sale.
ActionTypeStringFalseNoThe type of order action that the sale represents.
LineTypeStringFalseNoThe line type associated with the sale.
QuantityIntFalseNoThe number of units either ordered or intended to be returned.
TotalAmountPresentmentMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Decimal money amount.
TotalAmountPresentmentCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Currency of the money.
TotalAmountShopMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Decimal money amount.
TotalAmountShopMoneyCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Currency of the money.
TotalTaxAmountPresentmentMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Decimal money amount.
TotalTaxAmountPresentmentCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Currency of the money.
TotalTaxAmountShopMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in shop currency. Decimal money amount.
TotalTaxAmountShopMoneyCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in shop currency. Currency of the money.
TotalDiscountAmountBeforeTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountBeforeTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Currency of the money.
TotalDiscountAmountAfterTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountAfterTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountAfterTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountAfterTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Currency of the money.
TaxesStringFalseNoThe individual taxes associated with the sale.
TipSaleLineItemIdStringFalseNoA sale associated with a tip. The line item for the associated sale. A globally-unique ID.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
OrderIdStringFalseOrders.IdNoThe parent resource of the agreement.
AgreementIdStringFalseNoThe unique ID for the agreement.
Id [KEY]StringFalseNoThe unique ID for the sale.
ActionTypeStringFalseNoThe type of order action that the sale represents.
LineTypeStringFalseNoThe line type associated with the sale.
QuantityIntFalseNoThe number of units either ordered or intended to be returned.
TotalAmountPresentmentMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Decimal money amount.
TotalAmountPresentmentCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Currency of the money.
TotalAmountShopMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Decimal money amount.
TotalAmountShopMoneyCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Currency of the money.
TotalTaxAmountPresentmentMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Decimal money amount.
TotalTaxAmountPresentmentCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Currency of the money.
TotalTaxAmountShopMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in shop currency. Decimal money amount.
TotalTaxAmountShopMoneyCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in shop currency. Currency of the money.
TotalDiscountAmountBeforeTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountBeforeTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Currency of the money.
TotalDiscountAmountAfterTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountAfterTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountAfterTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountAfterTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Currency of the money.
TaxesStringFalseNoThe individual taxes associated with the sale.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
HostIdStringFalseOrders.IdNoA globally-unique ID.
AppTitleStringFalseNoThe name of the app that created the event.
AttributeToAppBoolFalseNoWhether the event was created by an app.
AttributeToUserBoolFalseNoWhether the event was caused by an admin user.
CreatedAtDatetimeFalseNoThe date and time when the event was created.
CriticalAlertBoolFalseNoWhether the event is critical.
MessageStringFalseNoHuman readable text that describes the event.
CommentEventAuthorIdStringFalseNoThe id of the staff member that authored the comment event.
CommentEventCanDeleteBoolFalseNoWhether the comment event can be deleted. If true, then the comment event can be deleted.
CommentEventCanEditBoolFalseNoWhether the comment event can edited. If true, then the comment event can be edited.
CommentEventEditedBoolFalseNoWhether the comment event has been edited. If true, then the comment event has been edited.
CommentEventRawMessageStringFalseNoThe raw body of the comment event.
CommentEventSubjectIdStringFalseNoThe parent subject to which the comment event belongs.
CommentEventEmbedCustomerIdStringFalseNoThe object reference associated with the comment event.
CommentEventEmbedDraftOrderIdStringFalseNoThe object reference associated with the comment event.
CommentEventEmbedOrderIdStringFalseNoThe object reference associated with the comment event.
CommentEventEmbedProductIdStringFalseNoThe object reference associated with the comment event.
CommentEventEmbedProductVariantIdStringFalseNoThe object reference associated with the comment event.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
ResourceId [KEY]StringFalseOrderLineItems.IdNoA globally-unique ID.
Key [KEY]StringFalseNoKey or name of the attribute.
ValueStringFalseNoValue of the attribute.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
OrderLineItemId [KEY]StringFalseNoThe ID of the Order to return.
DiscountApplicationIndex [KEY]DecimalFalseNoAn ordered index that can be used to identify the discount application and indicate the precedence of the discount application for calculations.
AllocatedAmountSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
AllocatedAmountSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
AllocatedAmountSetShopMoneyAmountDecimalFalseNoDecimal money amount.
AllocatedAmountSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
LineItemIdStringFalseOrderLineItems.IdNoA globally-unique ID.
Id [KEY]StringFalseNoA globally-unique ID.
CountryCodeOfOriginStringFalseNoThe ISO 3166-1 alpha-2 country code of the country of origin used in calculating the duty.
HarmonizedSystemCodeStringFalseNoThe harmonized system code of the item used in calculating the duty.
PricePresentmentMoneyAmountDecimalFalseNoDecimal money amount.
PricePresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
PriceShopMoneyAmountDecimalFalseNoDecimal money amount.
PriceShopMoneyCurrencyCodeStringFalseNoCurrency of the money.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
ResourceIdStringFalseOrders.IdNoA globally-unique ID.
NameStringFalseNoThe title of the product, optionally appended with the title of the variant (if applicable).
TitleStringFalseNoThe title of the product at time of order creation.
VariantTitleStringFalseNoThe title of the variant at time of order creation.
VariantIdStringFalseNoA globally-unique ID.
ProductIdStringFalseNoA globally-unique ID.
SellingPlanSellingPlanIdStringFalseNoThe ID of the selling plan associated with the line item.
QuantityIntFalseNoThe number of variant units ordered.
RestockableBoolFalseNoWhether the line item can be restocked.
SkuStringFalseNoThe variant SKU number.
TaxableBoolFalseNoWhether the variant is taxable.
VendorStringFalseNoThe name of the vendor who made the variant.
CurrentQuantityIntFalseNoThe line item's quantity, minus the removed quantity.
MerchantEditableBoolFalseNoWhether the line item can be edited or not.
RefundableQuantityIntFalseNoThe line item's quantity, minus the removed quantity.
RequiresShippingBoolFalseNoWhether physical shipping is required for the variant.
UnfulfilledQuantityIntFalseNoThe number of units not yet fulfilled.
NonFulfillableQuantityIntFalseNoThe total number of units that can't be fulfilled. For example, if items have been refunded, or the item is not something that can be fulfilled, like a tip. Please see the object for more fulfillment details.
IsGiftCardBoolFalseNoWhether the line item represents the purchase of a gift card.
DiscountedTotalSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
DiscountedTotalSetPresentmentMoneyAmountWithCodeDiscountsDecimalFalseNoDecimal money amount.
DiscountedTotalSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
DiscountedTotalSetShopMoneyAmountDecimalFalseNoDecimal money amount.
DiscountedTotalSetShopMoneyAmountWithCodeDiscountsDecimalFalseNoDecimal money amount.
DiscountedTotalSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
DiscountedUnitPriceSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
DiscountedUnitPriceSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
DiscountedUnitPriceSetShopMoneyAmountDecimalFalseNoDecimal money amount.
DiscountedUnitPriceSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
ImageIdStringFalseNoA unique ID for the image.
ImageWidthIntFalseNoThe original width of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
ImageAltTextStringFalseNoA word or phrase to share the nature or contents of an image.
ImageHeightIntFalseNoThe original height of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
ImageUrlStringFalseNoThe location of the image as a URL.
OriginalTotalSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
OriginalTotalSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
OriginalTotalSetShopMoneyAmountDecimalFalseNoDecimal money amount.
OriginalTotalSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
OriginalUnitPriceSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
OriginalUnitPriceSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
OriginalUnitPriceSetShopMoneyAmountDecimalFalseNoDecimal money amount.
OriginalUnitPriceSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
TotalDiscountSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
TotalDiscountSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
TotalDiscountSetShopMoneyAmountDecimalFalseNoDecimal money amount.
TotalDiscountSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
UnfulfilledDiscountedTotalSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
UnfulfilledDiscountedTotalSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
UnfulfilledDiscountedTotalSetShopMoneyAmountDecimalFalseNoDecimal money amount.
UnfulfilledDiscountedTotalSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
UnfulfilledOriginalTotalSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
UnfulfilledOriginalTotalSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
UnfulfilledOriginalTotalSetShopMoneyAmountDecimalFalseNoDecimal money amount.
UnfulfilledOriginalTotalSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
OrderUpdatedAtDatetimeFalseNoThe date and time when the order was modified last.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
LineItemIdStringFalseOrderNonFulfillableLineItems.IdNoA globally-unique ID.
Id [KEY]StringFalseNoA globally-unique ID.
CountryCodeOfOriginStringFalseNoThe ISO 3166-1 alpha-2 country code of the country of origin used in calculating the duty.
HarmonizedSystemCodeStringFalseNoThe harmonized system code of the item used in calculating the duty.
PricePresentmentMoneyAmountDecimalFalseNoDecimal money amount.
PricePresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
PriceShopMoneyAmountDecimalFalseNoDecimal money amount.
PriceShopMoneyCurrencyCodeStringFalseNoCurrency of the money.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
ResourceIdStringFalseOrders.IdNoA globally-unique ID.
NameStringFalseNoThe title of the product, optionally appended with the title of the variant (if applicable).
TitleStringFalseNoThe title of the product at time of order creation.
VariantTitleStringFalseNoThe title of the variant at time of order creation.
VariantIdStringFalseNoA globally-unique ID.
ProductIdStringFalseNoA globally-unique ID.
SellingPlanSellingPlanIdStringFalseNoThe ID of the selling plan associated with the line item.
QuantityIntFalseNoThe number of variant units ordered.
RestockableBoolFalseNoWhether the line item can be restocked.
SkuStringFalseNoThe variant SKU number.
TaxableBoolFalseNoWhether the variant is taxable.
VendorStringFalseNoThe name of the vendor who made the variant.
CurrentQuantityIntFalseNoThe line item's quantity, minus the removed quantity.
MerchantEditableBoolFalseNoWhether the line item can be edited or not.
RefundableQuantityIntFalseNoThe line item's quantity, minus the removed quantity.
RequiresShippingBoolFalseNoWhether physical shipping is required for the variant.
UnfulfilledQuantityIntFalseNoThe number of units not yet fulfilled.
NonFulfillableQuantityIntFalseNoThe total number of units that can't be fulfilled. For example, if items have been refunded, or the item is not something that can be fulfilled, like a tip. Please see the object for more fulfillment details.
IsGiftCardBoolFalseNoWhether the line item represents the purchase of a gift card.
DiscountedTotalSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
DiscountedTotalSetPresentmentMoneyAmountWithCodeDiscountsDecimalFalseNoDecimal money amount.
DiscountedTotalSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
DiscountedTotalSetShopMoneyAmountDecimalFalseNoDecimal money amount.
DiscountedTotalSetShopMoneyAmountWithCodeDiscountsDecimalFalseNoDecimal money amount.
DiscountedTotalSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
DiscountedUnitPriceSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
DiscountedUnitPriceSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
DiscountedUnitPriceSetShopMoneyAmountDecimalFalseNoDecimal money amount.
DiscountedUnitPriceSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
ImageIdStringFalseNoA unique ID for the image.
ImageWidthIntFalseNoThe original width of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
ImageAltTextStringFalseNoA word or phrase to share the nature or contents of an image.
ImageHeightIntFalseNoThe original height of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
ImageUrlStringFalseNoThe location of the image as a URL.
OriginalTotalSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
OriginalTotalSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
OriginalTotalSetShopMoneyAmountDecimalFalseNoDecimal money amount.
OriginalTotalSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
OriginalUnitPriceSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
OriginalUnitPriceSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
OriginalUnitPriceSetShopMoneyAmountDecimalFalseNoDecimal money amount.
OriginalUnitPriceSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
TotalDiscountSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
TotalDiscountSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
TotalDiscountSetShopMoneyAmountDecimalFalseNoDecimal money amount.
TotalDiscountSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
UnfulfilledDiscountedTotalSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
UnfulfilledDiscountedTotalSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
UnfulfilledDiscountedTotalSetShopMoneyAmountDecimalFalseNoDecimal money amount.
UnfulfilledDiscountedTotalSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
UnfulfilledOriginalTotalSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
UnfulfilledOriginalTotalSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
UnfulfilledOriginalTotalSetShopMoneyAmountDecimalFalseNoDecimal money amount.
UnfulfilledOriginalTotalSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
OrderIdStringFalseOrders.IdNoThe parent resource of the agreement.
AgreementIdStringFalseNoThe unique ID for the agreement.
Id [KEY]StringFalseNoThe unique ID for the sale.
ActionTypeStringFalseNoThe type of order action that the sale represents.
LineTypeStringFalseNoThe line type associated with the sale.
QuantityIntFalseNoThe number of units either ordered or intended to be returned.
TotalAmountPresentmentMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Decimal money amount.
TotalAmountPresentmentCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Currency of the money.
TotalAmountShopMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Decimal money amount.
TotalAmountShopMoneyCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Currency of the money.
TotalTaxAmountPresentmentMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Decimal money amount.
TotalTaxAmountPresentmentCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Currency of the money.
TotalTaxAmountShopMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in shop currency. Decimal money amount.
TotalTaxAmountShopMoneyCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in shop currency. Currency of the money.
TotalDiscountAmountBeforeTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountBeforeTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Currency of the money.
TotalDiscountAmountAfterTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountAfterTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountAfterTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountAfterTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Currency of the money.
TaxesStringFalseNoThe individual taxes associated with the sale.
AdditionalFeeSaleAdditionalFeeIdStringFalseNoA sale associated with an additional fee charge. The additional fees for the associated sale. A globally-unique ID.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
OrderIdStringFalseOrders.IdNoThe parent resource of the agreement.
AgreementIdStringFalseNoThe unique ID for the agreement.
Id [KEY]StringFalseNoThe unique ID for the sale.
ActionTypeStringFalseNoThe type of order action that the sale represents.
LineTypeStringFalseNoThe line type associated with the sale.
QuantityIntFalseNoThe number of units either ordered or intended to be returned.
TotalAmountPresentmentMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Decimal money amount.
TotalAmountPresentmentCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Currency of the money.
TotalAmountShopMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Decimal money amount.
TotalAmountShopMoneyCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Currency of the money.
TotalTaxAmountPresentmentMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Decimal money amount.
TotalTaxAmountPresentmentCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Currency of the money.
TotalTaxAmountShopMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in shop currency. Decimal money amount.
TotalTaxAmountShopMoneyCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in shop currency. Currency of the money.
TotalDiscountAmountBeforeTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountBeforeTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Currency of the money.
TotalDiscountAmountAfterTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountAfterTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountAfterTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountAfterTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Currency of the money.
TaxesStringFalseNoThe individual taxes associated with the sale.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
OrderIdStringFalseOrders.IdNoThe parent resource of the agreement.
AgreementIdStringFalseNoThe unique ID for the agreement.
Id [KEY]StringFalseNoThe unique ID for the sale.
ActionTypeStringFalseNoThe type of order action that the sale represents.
LineTypeStringFalseNoThe line type associated with the sale.
QuantityIntFalseNoThe number of units either ordered or intended to be returned.
TotalAmountPresentmentMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Decimal money amount.
TotalAmountPresentmentCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Currency of the money.
TotalAmountShopMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Decimal money amount.
TotalAmountShopMoneyCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Currency of the money.
TotalTaxAmountPresentmentMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Decimal money amount.
TotalTaxAmountPresentmentCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Currency of the money.
TotalTaxAmountShopMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in shop currency. Decimal money amount.
TotalTaxAmountShopMoneyCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in shop currency. Currency of the money.
TotalDiscountAmountBeforeTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountBeforeTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Currency of the money.
TotalDiscountAmountAfterTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountAfterTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountAfterTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountAfterTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Currency of the money.
TaxesStringFalseNoThe individual taxes associated with the sale.
DutySaleDutyIdStringFalseNoA sale associated with a duty charge. The duty for the associated sale. A globally-unique ID.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
OrderIdStringFalseOrders.IdNoThe parent resource of the agreement.
AgreementIdStringFalseNoThe unique ID for the agreement.
Id [KEY]StringFalseNoThe unique ID for the sale.
ActionTypeStringFalseNoThe type of order action that the sale represents.
LineTypeStringFalseNoThe line type associated with the sale.
QuantityIntFalseNoThe number of units either ordered or intended to be returned.
TotalAmountPresentmentMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Decimal money amount.
TotalAmountPresentmentCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Currency of the money.
TotalAmountShopMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Decimal money amount.
TotalAmountShopMoneyCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Currency of the money.
TotalTaxAmountPresentmentMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Decimal money amount.
TotalTaxAmountPresentmentCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Currency of the money.
TotalTaxAmountShopMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in shop currency. Decimal money amount.
TotalTaxAmountShopMoneyCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in shop currency. Currency of the money.
TotalDiscountAmountBeforeTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountBeforeTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Currency of the money.
TotalDiscountAmountAfterTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountAfterTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountAfterTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountAfterTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Currency of the money.
TaxesStringFalseNoThe individual taxes associated with the sale.
GiftCardSaleLineItemIdStringFalseNoA sale associated with a gift card. The line item for the associated sale. A globally-unique ID.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
OrderIdStringFalseOrders.IdNoThe parent resource of the agreement.
AgreementIdStringFalseNoThe unique ID for the agreement.
Id [KEY]StringFalseNoThe unique ID for the sale.
ActionTypeStringFalseNoThe type of order action that the sale represents.
LineTypeStringFalseNoThe line type associated with the sale.
QuantityIntFalseNoThe number of units either ordered or intended to be returned.
TotalAmountPresentmentMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Decimal money amount.
TotalAmountPresentmentCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Currency of the money.
TotalAmountShopMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Decimal money amount.
TotalAmountShopMoneyCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Currency of the money.
TotalTaxAmountPresentmentMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Decimal money amount.
TotalTaxAmountPresentmentCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Currency of the money.
TotalTaxAmountShopMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in shop currency. Decimal money amount.
TotalTaxAmountShopMoneyCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in shop currency. Currency of the money.
TotalDiscountAmountBeforeTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountBeforeTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Currency of the money.
TotalDiscountAmountAfterTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountAfterTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountAfterTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountAfterTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Currency of the money.
TaxesStringFalseNoThe individual taxes associated with the sale.
ProductSaleLineItemIdStringFalseNoA sale associated with a product. The line item for the associated sale. A globally-unique ID.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
OrderIdStringFalseOrders.IdNoThe parent resource of the agreement.
Id [KEY]StringFalseNoThe unique ID for the agreement.
HappenedAtDatetimeFalseNoThe date and time at which the agreement occurred.
ReasonStringFalseNoThe reason the agreement was created.
UserIdStringFalseNoThe staff member associated with the agreement. A globally-unique ID.(This column is available only with a ShopifyPlus subscription)
AppApiKeyStringFalseNoThe application that created the agreement. A unique application API identifier.
RefundIdStringFalseRefunds.IdNoThe refund associated with the agreement.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
OrderIdStringFalseOrders.IdNoThe parent resource of the agreement.
AgreementIdStringFalseNoThe unique ID for the agreement.
Id [KEY]StringFalseNoThe unique ID for the sale.
ActionTypeStringFalseNoThe type of order action that the sale represents.
LineTypeStringFalseNoThe line type associated with the sale.
QuantityIntFalseNoThe number of units either ordered or intended to be returned.
TotalAmountPresentmentMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Decimal money amount.
TotalAmountPresentmentCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Currency of the money.
TotalAmountShopMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Decimal money amount.
TotalAmountShopMoneyCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Currency of the money.
TotalTaxAmountPresentmentMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Decimal money amount.
TotalTaxAmountPresentmentCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Currency of the money.
TotalTaxAmountShopMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in shop currency. Decimal money amount.
TotalTaxAmountShopMoneyCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in shop currency. Currency of the money.
TotalDiscountAmountBeforeTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountBeforeTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Currency of the money.
TotalDiscountAmountAfterTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountAfterTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountAfterTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountAfterTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Currency of the money.
TaxesStringFalseNoThe individual taxes associated with the sale.
ShippingLineSaleShippingLineIdStringFalseNoA sale associated with a shipping charge. The shipping line item for the associated sale. shippingLine is not available if the SaleActionType is a return. A globally-unique ID.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
OrderIdStringFalseOrders.IdNoThe parent resource of the agreement.
AgreementIdStringFalseNoThe unique ID for the agreement.
Id [KEY]StringFalseNoThe unique ID for the sale.
ActionTypeStringFalseNoThe type of order action that the sale represents.
LineTypeStringFalseNoThe line type associated with the sale.
QuantityIntFalseNoThe number of units either ordered or intended to be returned.
TotalAmountPresentmentMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Decimal money amount.
TotalAmountPresentmentCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Currency of the money.
TotalAmountShopMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Decimal money amount.
TotalAmountShopMoneyCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Currency of the money.
TotalTaxAmountPresentmentMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Decimal money amount.
TotalTaxAmountPresentmentCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Currency of the money.
TotalTaxAmountShopMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in shop currency. Decimal money amount.
TotalTaxAmountShopMoneyCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in shop currency. Currency of the money.
TotalDiscountAmountBeforeTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountBeforeTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Currency of the money.
TotalDiscountAmountAfterTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountAfterTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountAfterTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountAfterTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Currency of the money.
TaxesStringFalseNoThe individual taxes associated with the sale.
TipSaleLineItemIdStringFalseNoA sale associated with a tip. The line item for the associated sale. A globally-unique ID.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
OrderIdStringFalseOrders.IdNoThe parent resource of the agreement.
AgreementIdStringFalseNoThe unique ID for the agreement.
Id [KEY]StringFalseNoThe unique ID for the sale.
ActionTypeStringFalseNoThe type of order action that the sale represents.
LineTypeStringFalseNoThe line type associated with the sale.
QuantityIntFalseNoThe number of units either ordered or intended to be returned.
TotalAmountPresentmentMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Decimal money amount.
TotalAmountPresentmentCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in presentment currency. Currency of the money.
TotalAmountShopMoneyAmountDecimalFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Decimal money amount.
TotalAmountShopMoneyCurrencyCodeStringFalseNoThe total sale amount after taxes and discounts. Amount in shop currency. Currency of the money.
TotalTaxAmountPresentmentMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Decimal money amount.
TotalTaxAmountPresentmentCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in presentment currency. Currency of the money.
TotalTaxAmountShopMoneyAmountDecimalFalseNoThe total amount of taxes for the sale. Amount in shop currency. Decimal money amount.
TotalTaxAmountShopMoneyCurrencyCodeStringFalseNoThe total amount of taxes for the sale. Amount in shop currency. Currency of the money.
TotalDiscountAmountBeforeTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountBeforeTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountBeforeTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale before taxes. Amount in shop currency. Currency of the money.
TotalDiscountAmountAfterTaxesPresentmentMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Decimal money amount.
TotalDiscountAmountAfterTaxesPresentmentCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in presentment currency. Currency of the money.
TotalDiscountAmountAfterTaxesShopMoneyAmountDecimalFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Decimal money amount.
TotalDiscountAmountAfterTaxesShopMoneyCurrencyCodeStringFalseNoThe total discounts allocated to the sale after taxes. Amount in shop currency. Currency of the money.
TaxesStringFalseNoThe individual taxes associated with the sale.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
OrderIdStringTrueNoA globally-unique ID.
RiskLevelStringTrueNoThe likelihood that the order is fraudulent, based on this risk assessment.
FactsStringTrueNoOptional facts used to describe the risk assessment. The values in here are specific to the provider.
ProviderIdStringTrueNoA globally-unique ID.
ProviderTitleStringTrueNoName of the app.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
UnpaidBoolTrueNoWhether no payments have been made for the order.
FullyPaidBoolTrueNoWhether the order has been paid in full.
SourceIdentifierStringTrueNoA unique POS or third party order identifier. For example, '1234-12-1000' or '111-98567-54'. The 'receipt_number' field is derived from this value for POS orders.
LegacyResourceIdStringTrueNoThe ID of the corresponding resource in the REST Admin API.
CanMarkAsPaidBoolTrueNoWhether the order can be manually marked as paid.
NameStringTrueNoThe unique identifier for the order that appears on the order page in the Shopify admin and the order status page. For example, '#1001', 'EN1001', or '1001-A'. This value isn't unique across multiple stores.
PaymentGatewayNamesStringTrueNoA list of the names of all payment gateways used for the order. For example, 'Shopify Payments' and 'Cash on Delivery (COD)'.
CapturableBoolTrueNoWhether payment for the order can be captured.
ClosedBoolTrueNoWhether the order is closed.
ConfirmedBoolTrueNoWhether inventory has been reserved for the order.
EditedBoolTrueNoWhether the order has had any edits applied.
EmailStringFalseNoThe email address associated with the customer.
FulfillableBoolTrueNoWhether there are line items that can be fulfilled. This field returns 'false' when the order has no fulfillable line items. For a more granular view of the fulfillment status, refer to the object.
NoteStringFalseNoThe contents of the note associated with the order.
PhoneStringTrueNoThe phone number associated with the customer.
RefundableBoolTrueNoWhether the order can be refunded.
RestockableBoolTrueNoWhether any line item on the order can be restocked.
TagsStringTrueNoA comma separated list of tags associated with the order. Updating 'tags' overwrites any existing tags that were previously added to the order. To add new tags without overwriting existing tags, use the mutation.
TestBoolTrueNoWhether the order is a test. Test orders are made using the Shopify Bogus Gateway or a payment provider with test mode enabled. A test order cannot be converted into a real order and vice versa.
CancelReasonStringTrueNoThe reason provided when the order was canceled. Returns 'null' if the order wasn't canceled.
CancelledAtDatetimeTrueNoThe date and time when the order was canceled. Returns 'null' if the order wasn't canceled.
ClientIpStringTrueNoThe IP address of the API client that created the order.
ClosedAtDatetimeTrueNoThe date and time when the order was closed. Returns 'null' if the order is not closed.
ConfirmationNumberStringTrueNoA randomly generated alpha-numeric identifier for the order that may be shown to the customer instead of the sequential order name. For example, XPAV284CT, R50KELTJP or 35PKUN0UJ. This value isn't guaranteed to be unique.
CurrencyCodeStringTrueNoThe shop currency when the order was placed.
CustomerLocaleStringTrueNoA two-letter or three-letter language code, optionally followed by a region modifier.
DiscountCodeStringTrueNoThe discount code used for the order.
DiscountCodesStringTrueNoThe discount codes used for the order.
EstimatedTaxesBoolTrueNoWhether taxes on the order are estimated. This field returns 'false' when taxes on the order are finalized and aren't subject to any changes.
MerchantEditableBoolTrueNoWhether the order can be edited by the merchant. For example, canceled orders can't be edited.
ProcessedAtDatetimeTrueNoThe date and time when the order was processed. This date and time might not match the date and time when the order was created.
RequiresShippingBoolTrueNoWhether the order has shipping lines or at least one line item on the order that requires shipping.
RiskRecommendationStringTrueNoThe recommendation for the order based on the results of the risk assessments. This suggests the action the merchant should take with regards to its risk of fraud.
ReturnStatusStringTrueNoThe order's aggregated return status for display purposes.
TaxesIncludedBoolTrueNoWhether taxes are included in the subtotal price of the order.
TotalWeightStringTrueNoThe total weight of the order before returns, in grams.
CanNotifyCustomerBoolTrueNoWhether a customer email exists for the order.
CurrentTotalWeightStringTrueNoThe total weight of the order after returns, in grams.
CustomerAcceptsMarketingBoolTrueNoWhether the customer agreed to receive marketing materials.
DisplayFinancialStatusStringTrueNoThe financial status of the order that can be shown to the merchant. This field does not capture all the details of an order's financial state. It should only be used for display summary purposes.
DisplayFulfillmentStatusStringTrueNoThe fulfillment status for the order that can be shown to the merchant. This field does not capture all the details of an order's fulfillment state. It should only be used for display summary purposes. For a more granular view of the fulfillment status, refer to the object.
HasTimelineCommentBoolTrueNoWhether the merchant added a timeline comment to the order.
MerchantEditableErrorsStringTrueNoA list of reasons why the order can't be edited. For example, 'Canceled orders can't be edited'.
PresentmentCurrencyCodeStringTrueNoThe payment 'CurrencyCode' of the customer for the order.
RegisteredSourceUrlStringTrueNoThe URL of the source that the order originated from, if found in the domain registry.
SubtotalLineItemsQuantityIntTrueNoThe sum of the quantities for all line items that contribute to the order's subtotal price.
BillingAddressMatchesShippingAddressBoolTrueNoWhether the billing address matches the shipping address.
CurrentSubtotalLineItemsQuantityIntTrueNoThe sum of the quantities for all line items that contribute to the order's current subtotal price.
CreatedAtDatetimeTrueNoDate and time when the order was created in Shopify.
UpdatedAtDatetimeTrueNoThe date and time when the order was modified last.
AppIdStringTrueNoThe application ID.
MerchantOfRecordAppIdStringTrueNoThe application ID.
PhysicalLocationIdStringTrueNoA globally-unique ID.
ChannelInformationIdStringTrueNoA globally-unique ID.
ChannelInformationChannelIdStringTrueNoThe unique ID for the channel.
ChannelInformationAppIdStringTrueNoA globally-unique ID.
PublicationIdStringTrueNoA globally-unique ID.
PurchasingEntityCustomerIdStringTrueNoA globally-unique ID.
PurchasingEntityCompanyIdStringTrueNoA globally-unique ID.
CustomerIdStringTrueNoA globally-unique ID.
CustomerFirstNameStringTrueNoThe customer's first name.
CustomerLastNameStringTrueNoThe customer's last name.
CustomerJourneySummaryReadyBoolTrueNoWhether the attributed sessions for the order have been created yet.
CustomerJourneySummaryMomentsCountIntTrueNoThe total number of customer moments associated with this order. Returns null if the order is still in the process of being attributed.
CustomerJourneySummaryMomentsCountPrecisionStringTrueNoThe count's precision, or the exactness of the value.
CustomerJourneySummaryCustomerOrderIndexIntTrueNoThe position of the current order within the customer's order history. Test orders aren't included.
CustomerJourneySummaryDaysToConversionIntTrueNoThe number of days between the first session and the order creation date. The first session represents the first session since the last order, or the first session within the 30 day attribution window, if more than 30 days have passed since the last order.
CustomerJourneySummaryFirstVisitIdStringTrueNoA globally-unique ID.
CustomerJourneySummaryFirstVisitSourceStringTrueNoSource from which the customer visited the store, such as a platform (Facebook, Google), email, direct, a website domain, QR code, or unknown.
CustomerJourneySummaryFirstVisitLandingPageStringTrueNoURL of the first page the customer landed on for the session.
CustomerJourneySummaryFirstVisitOccurredAtDatetimeTrueNoThe date and time when the customer's session occurred.
CustomerJourneySummaryFirstVisitReferralCodeStringTrueNoMarketing referral code from the link that the customer clicked to visit the store. Supports the following URL attributes: ref, source, or r. For example, if the URL is myshopifystore. com/products/slide?ref=j2tj1tn2, then this value is j2tj1tn2.
CustomerJourneySummaryFirstVisitReferrerUrlStringTrueNoWebpage where the customer clicked a link that sent them to the online store. For example, https: //randomblog. com/page1 or android-app: //com. google. android. gm.
CustomerJourneySummaryFirstVisitSourceDescriptionStringTrueNoDescribes the source explicitly for first or last session.
CustomerJourneySummaryFirstVisitSourceTypeStringTrueNoType of marketing tactic.
CustomerJourneySummaryFirstVisitLandingPageHtmlStringTrueNoLanding page information with URL linked in HTML. For example, the first page the customer visited was store. myshopify. com/products/1.
CustomerJourneySummaryFirstVisitReferralInfoHtmlStringTrueNoReferral information with URLs linked in HTML.
CustomerJourneySummaryLastVisitIdStringTrueNoA globally-unique ID.
CustomerJourneySummaryLastVisitSourceStringTrueNoSource from which the customer visited the store, such as a platform (Facebook, Google), email, direct, a website domain, QR code, or unknown.
CustomerJourneySummaryLastVisitLandingPageStringTrueNoURL of the first page the customer landed on for the session.
CustomerJourneySummaryLastVisitOccurredAtDatetimeTrueNoThe date and time when the customer's session occurred.
CustomerJourneySummaryLastVisitReferralCodeStringTrueNoMarketing referral code from the link that the customer clicked to visit the store. Supports the following URL attributes: ref, source, or r. For example, if the URL is myshopifystore. com/products/slide?ref=j2tj1tn2, then this value is j2tj1tn2.
CustomerJourneySummaryLastVisitReferrerUrlStringTrueNoWebpage where the customer clicked a link that sent them to the online store. For example, https: //randomblog. com/page1 or android-app: //com. google. android. gm.
CustomerJourneySummaryLastVisitSourceDescriptionStringTrueNoDescribes the source explicitly for first or last session.
CustomerJourneySummaryLastVisitSourceTypeStringTrueNoType of marketing tactic.
CustomerJourneySummaryLastVisitLandingPageHtmlStringTrueNoLanding page information with URL linked in HTML. For example, the first page the customer visited was store. myshopify. com/products/1.
CustomerJourneySummaryLastVisitReferralInfoHtmlStringTrueNoReferral information with URLs linked in HTML.
DisplayAddressIdStringTrueNoA globally-unique ID.
DisplayAddressCoordinatesValidatedBoolTrueNoWhether the address coordinates are valid.
DisplayAddressNameStringTrueNoThe full name of the customer, based on firstName and lastName.
DisplayAddressFirstNameStringTrueNoThe first name of the customer.
DisplayAddressLastNameStringTrueNoThe last name of the customer.
DisplayAddressAddress1StringTrueNoThe first line of the address. Typically the street address or PO Box number.
DisplayAddressAddress2StringTrueNoThe second line of the address. Typically the number of the apartment, suite, or unit.
DisplayAddressCityStringTrueNoThe name of the city, district, village, or town.
DisplayAddressCompanyStringTrueNoThe name of the customer's company or organization.
DisplayAddressCountryStringTrueNoThe name of the country.
DisplayAddressLatitudeDoubleTrueNoThe latitude coordinate of the customer address.
DisplayAddressLongitudeDoubleTrueNoThe longitude coordinate of the customer address.
DisplayAddressPhoneStringTrueNoA unique phone number for the customer. Formatted using E. 164 standard. For example, +16135551111.
DisplayAddressProvinceStringTrueNoThe region of the address, such as the province, state, or district.
DisplayAddressZipStringTrueNoThe zip or postal code of the address.
DisplayAddressFormattedAreaStringTrueNoA comma-separated list of the values for city, province, and country.
DisplayAddressProvinceCodeStringTrueNoThe two-letter code for the region. For example, ON.
DisplayAddressCountryCodeV2StringTrueNoThe two-letter code for the country of the address. For example, US.
BillingAddressIdStringTrueNoA globally-unique ID.
BillingAddressCoordinatesValidatedBoolTrueNoWhether the address coordinates are valid.
BillingAddressNameStringTrueNoThe full name of the customer, based on firstName and lastName.
BillingAddressFirstNameStringTrueNoThe first name of the customer.
BillingAddressLastNameStringTrueNoThe last name of the customer.
BillingAddressAddress1StringTrueNoThe first line of the address. Typically the street address or PO Box number.
BillingAddressAddress2StringTrueNoThe second line of the address. Typically the number of the apartment, suite, or unit.
BillingAddressCityStringTrueNoThe name of the city, district, village, or town.
BillingAddressCompanyStringTrueNoThe name of the customer's company or organization.
BillingAddressCountryStringTrueNoThe name of the country.
BillingAddressLatitudeDoubleTrueNoThe latitude coordinate of the customer address.
BillingAddressLongitudeDoubleTrueNoThe longitude coordinate of the customer address.
BillingAddressPhoneStringTrueNoA unique phone number for the customer. Formatted using E. 164 standard. For example, +16135551111.
BillingAddressProvinceStringTrueNoThe region of the address, such as the province, state, or district.
BillingAddressZipStringTrueNoThe zip or postal code of the address.
BillingAddressFormattedAreaStringTrueNoA comma-separated list of the values for city, province, and country.
BillingAddressProvinceCodeStringTrueNoThe two-letter code for the region. For example, ON.
BillingAddressCountryCodeV2StringTrueNoThe two-letter code for the country of the address. For example, US.
ShippingAddressIdStringFalseNoA globally-unique ID.
ShippingAddressCoordinatesValidatedBoolTrueNoWhether the address coordinates are valid.
ShippingAddressNameStringTrueNoThe full name of the customer, based on firstName and lastName.
ShippingAddressFirstNameStringFalseNoThe first name of the customer.
ShippingAddressLastNameStringFalseNoThe last name of the customer.
ShippingAddressAddress1StringFalseNoThe first line of the address. Typically the street address or PO Box number.
ShippingAddressAddress2StringFalseNoThe second line of the address. Typically the number of the apartment, suite, or unit.
ShippingAddressCityStringFalseNoThe name of the city, district, village, or town.
ShippingAddressCompanyStringFalseNoThe name of the customer's company or organization.
ShippingAddressCountryStringFalseNoThe name of the country.
ShippingAddressLatitudeDoubleTrueNoThe latitude coordinate of the customer address.
ShippingAddressLongitudeDoubleTrueNoThe longitude coordinate of the customer address.
ShippingAddressPhoneStringFalseNoA unique phone number for the customer. Formatted using E. 164 standard. For example, +16135551111.
ShippingAddressProvinceStringFalseNoThe region of the address, such as the province, state, or district.
ShippingAddressZipStringFalseNoThe zip or postal code of the address.
ShippingAddressFormattedAreaStringTrueNoA comma-separated list of the values for city, province, and country.
ShippingAddressProvinceCodeStringFalseNoThe two-letter code for the region. For example, ON.
ShippingAddressCountryCodeV2StringFalseNoThe two-letter code for the country of the address. For example, US.
ShippingLineIdStringTrueNoA globally-unique ID.
ShippingLineCarrierIdentifierStringTrueNoA reference to the carrier service that provided the rate. Present when the rate was computed by a third-party carrier service.
ShippingLineTitleStringTrueNoReturns the title of the shipping line.
ShippingLineCodeStringTrueNoA reference to the shipping method.
ShippingLineCustomBoolTrueNoWhether the shipping line is custom or not.
ShippingLinePhoneStringTrueNoThe phone number at the shipping address.
ShippingLineSourceStringTrueNoReturns the rate source for the shipping line.
ShippingLineDeliveryCategoryStringTrueNoThe general classification of the delivery method.
ShippingLineShippingRateHandleStringTrueNoA unique identifier for the shipping rate. The format can change without notice and is not meant to be shown to users.
ShippingLineRequestedFulfillmentServiceIdStringTrueNoThe ID of the fulfillment service.
PaymentTermsIdStringTrueNoA globally-unique ID.
PaymentTermsTranslatedNameStringTrueNoThe payment terms name, translated into the shop admin's preferred language.
PaymentTermsPaymentTermsNameStringTrueNoThe name of the payment terms template used to create the payment terms.
PaymentTermsOverdueBoolTrueNoWhether the payment terms have overdue payment schedules.
PaymentTermsDueInDaysIntTrueNoDuration of payment terms in days based on the payment terms template used to create the payment terms.
PaymentTermsPaymentTermsTypeStringTrueNoThe payment terms template type used to create the payment terms.
PaymentTermsDraftOrderIdStringTrueNoA globally-unique ID.
CartDiscountAmountSetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
CartDiscountAmountSetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
CartDiscountAmountSetShopMoneyAmountDecimalTrueNoDecimal money amount.
CartDiscountAmountSetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
ChannelInformationChannelDefinitionIdStringTrueNoThe unique ID for the channel definition.
CurrentCartDiscountAmountSetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
CurrentCartDiscountAmountSetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
CurrentCartDiscountAmountSetShopMoneyAmountDecimalTrueNoDecimal money amount.
CurrentCartDiscountAmountSetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
CurrentSubtotalPriceSetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
CurrentSubtotalPriceSetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
CurrentSubtotalPriceSetShopMoneyAmountDecimalTrueNoDecimal money amount.
CurrentSubtotalPriceSetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
CurrentTotalAdditionalFeesSetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
CurrentTotalAdditionalFeesSetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
CurrentTotalAdditionalFeesSetShopMoneyAmountDecimalTrueNoDecimal money amount.
CurrentTotalAdditionalFeesSetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
CurrentTotalDiscountsSetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
CurrentTotalDiscountsSetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
CurrentTotalDiscountsSetShopMoneyAmountDecimalTrueNoDecimal money amount.
CurrentTotalDiscountsSetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
CurrentTotalDutiesSetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
CurrentTotalDutiesSetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
CurrentTotalDutiesSetShopMoneyAmountDecimalTrueNoDecimal money amount.
CurrentTotalDutiesSetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
CurrentTotalPriceSetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
CurrentTotalPriceSetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
CurrentTotalPriceSetShopMoneyAmountDecimalTrueNoDecimal money amount.
CurrentTotalPriceSetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
CurrentTotalTaxSetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
CurrentTotalTaxSetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
CurrentTotalTaxSetShopMoneyAmountDecimalTrueNoDecimal money amount.
CurrentTotalTaxSetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
NetPaymentSetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
NetPaymentSetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
NetPaymentSetShopMoneyAmountDecimalTrueNoDecimal money amount.
NetPaymentSetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
OriginalTotalAdditionalFeesSetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
OriginalTotalAdditionalFeesSetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
OriginalTotalAdditionalFeesSetShopMoneyAmountDecimalTrueNoDecimal money amount.
OriginalTotalAdditionalFeesSetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
OriginalTotalDutiesSetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
OriginalTotalDutiesSetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
OriginalTotalDutiesSetShopMoneyAmountDecimalTrueNoDecimal money amount.
OriginalTotalDutiesSetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
OriginalTotalPriceSetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
OriginalTotalPriceSetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
OriginalTotalPriceSetShopMoneyAmountDecimalTrueNoDecimal money amount.
OriginalTotalPriceSetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
PaymentCollectionDetailsAdditionalPaymentCollectionUrlStringTrueNoThe URL to use for collecting an additional payment on the order.
RefundDiscrepancySetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
RefundDiscrepancySetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
RefundDiscrepancySetShopMoneyAmountDecimalTrueNoDecimal money amount.
RefundDiscrepancySetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
SubtotalPriceSetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
SubtotalPriceSetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
SubtotalPriceSetShopMoneyAmountDecimalTrueNoDecimal money amount.
SubtotalPriceSetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
TotalCapturableSetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
TotalCapturableSetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
TotalCapturableSetShopMoneyAmountDecimalTrueNoDecimal money amount.
TotalCapturableSetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
TotalDiscountsSetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
TotalDiscountsSetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
TotalDiscountsSetShopMoneyAmountDecimalTrueNoDecimal money amount.
TotalDiscountsSetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
TotalOutstandingSetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
TotalOutstandingSetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
TotalOutstandingSetShopMoneyAmountDecimalTrueNoDecimal money amount.
TotalOutstandingSetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
TotalPriceSetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
TotalPriceSetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
TotalPriceSetShopMoneyAmountDecimalTrueNoDecimal money amount.
TotalPriceSetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
TotalReceivedSetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
TotalReceivedSetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
TotalReceivedSetShopMoneyAmountDecimalTrueNoDecimal money amount.
TotalReceivedSetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
TotalRefundedSetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
TotalRefundedSetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
TotalRefundedSetShopMoneyAmountDecimalTrueNoDecimal money amount.
TotalRefundedSetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
TotalRefundedShippingSetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
TotalRefundedShippingSetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
TotalRefundedShippingSetShopMoneyAmountDecimalTrueNoDecimal money amount.
TotalRefundedShippingSetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
TotalShippingPriceSetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
TotalShippingPriceSetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
TotalShippingPriceSetShopMoneyAmountDecimalTrueNoDecimal money amount.
TotalShippingPriceSetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
TotalTaxSetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
TotalTaxSetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
TotalTaxSetShopMoneyAmountDecimalTrueNoDecimal money amount.
TotalTaxSetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
TotalTipReceivedSetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
TotalTipReceivedSetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
TotalTipReceivedSetShopMoneyAmountDecimalTrueNoDecimal money amount.
TotalTipReceivedSetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
RetailLocationIdStringTrueNoA globally-unique ID.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Title [KEY]StringFalseNoThe name of the tax.
ResourceId [KEY]StringFalseOrders.IdNoA globally-unique ID.
RateDoubleFalseNoThe proportion of the line item price that the tax represents as a decimal.
ChannelLiableBoolFalseNoWhether the channel that submitted the tax line is liable for remitting. A value of null indicates unknown liability for this tax line.
RatePercentageDoubleFalseNoThe proportion of the line item price that the tax represents as a percentage.
PriceSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
PriceSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
PriceSetShopMoneyAmountDecimalFalseNoDecimal money amount.
PriceSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
ResourceId [KEY]StringTrueOrders.IdNoA globally-unique ID.
PaymentIdStringTrueNoThe payment ID associated with the transaction.
ParentTransactionIdStringTrueNoThe associated parent transaction, for example the authorization of a capture.
AccountNumberStringTrueNoThe masked account number associated with the payment method.
GatewayStringTrueNoThe payment gateway used to process the transaction.
KindStringTrueNoThe kind of transaction.
StatusStringTrueNoThe status of this transaction.
TestBoolTrueNoWhether the transaction is a test transaction.
AuthorizationCodeStringTrueNoAuthorization code associated with the transaction.
ErrorCodeStringTrueNoA standardized error code, independent of the payment provider.
FormattedGatewayStringTrueNoThe human-readable payment gateway name used to process the transaction.
ManuallyCapturableBoolTrueNoWhether the transaction can be manually captured.
MultiCapturableBoolTrueNoWhether the transaction can be captured multiple times.
ProcessedAtDatetimeTrueNoDate and time when the transaction was processed.
ReceiptJsonStringTrueNoThe transaction receipt that the payment gateway attaches to the transaction. The value of this field depends on which payment gateway processed the transaction.
SettlementCurrencyStringTrueNoThe settlement currency.
AuthorizationExpiresAtDatetimeTrueNoThe time when the authorization expires. This field is available only to stores on a Shopify Plus plan and is populated only for Shopify Payments authorizations.
SettlementCurrencyRateDecimalTrueNoThe rate used when converting the transaction amount to settlement currency.
CreatedAtDatetimeTrueNoDate and time when the transaction was created.
CardPaymentDetailsNameStringTrueNoThe holder of the credit card.
CardPaymentDetailsBinStringTrueNoThe issuer identification number (IIN), formerly known as bank identification number (BIN) of the customer's credit card. This is made up of the first few digits of the credit card number.
CardPaymentDetailsCompanyStringTrueNoThe name of the company that issued the customer's credit card.
CardPaymentDetailsNumberStringTrueNoThe customer's credit card number, with most of the leading digits redacted.
CardPaymentDetailsWalletStringTrueNoDigital wallet used for the payment.
CardPaymentDetailsExpirationMonthIntTrueNoThe month in which the used credit card expires.
CardPaymentDetailsExpirationYearIntTrueNoThe year in which the used credit card expires.
CardPaymentDetailsAvsResultCodeStringTrueNoThe response code from the address verification system (AVS). The code is always a single letter.
CardPaymentDetailsCvvResultCodeStringTrueNoThe response code from the credit card company indicating whether the customer entered the card security code, or card verification value, correctly. The code is a single letter or empty string.
PaymentIconIdStringTrueNoA unique ID for the image.
PaymentIconWidthIntTrueNoThe original width of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
PaymentIconAltTextStringTrueNoA word or phrase to share the nature or contents of an image.
PaymentIconHeightIntTrueNoThe original height of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
AmountSetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
AmountSetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
AmountSetShopMoneyAmountDecimalTrueNoDecimal money amount.
AmountSetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
MaximumRefundableV2AmountDecimalTrueNoDecimal money amount.
MaximumRefundableV2CurrencyCodeStringTrueNoCurrency of the money.
ShopifyPaymentsSetExtendedAuthorizationSetExtendedAuthorizationExpiresAtDatetimeTrueNoThe time after which the extended authorization expires. After the expiry, the merchant is unable to capture the payment.
ShopifyPaymentsSetExtendedAuthorizationSetStandardAuthorizationExpiresAtDatetimeTrueNoThe time after which capture will incur an additional fee.
ShopifyPaymentsSetRefundSetAcquirerReferenceNumberStringTrueNoThe acquirer reference number (ARN) code generated for Visa/Mastercard transactions.
TotalUnsettledSetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
TotalUnsettledSetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
TotalUnsettledSetShopMoneyAmountDecimalTrueNoDecimal money amount.
TotalUnsettledSetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
AmountDecimalFalseYesThe amount to capture. The capture amount can't be greater than the amount of the authorized transaction.
CurrencyStringFalseYesThe amount to capture. The capture amount can't be greater than the amount of the authorized transaction.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
TitleStringFalseNoThe title of the page.
BodyStringFalseNoThe description of the page, complete with HTML formatting.
HandleStringFalseNoA human-friendly unique string for the page automatically generated from its title.
BodySummaryStringFalseNoSummary of the page body.
OnlineStoreUrlStringFalseNoThe URL used for viewing the resource on the shop's Online Store. Returns 'null' if the resource is currently not published to the Online Store sales channel.
CreatedAtDatetimeFalseNoThe timestamp of the page creation.
UpdatedAtDatetimeFalseNoThe timestamp of the latest page update.
SeoTitleStringFalseNoThe SEO title.
SeoDescriptionStringFalseNoThe meta description.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
PriceListId [KEY]StringFalsePriceLists.IdNoThe unique identifier of the price list.
ProductVariantId [KEY]StringFalseProductVariants.IdNoThe unique identifier of the product variant associated with this price.
OriginTypeStringFalseNoThe origin of a price, either fixed (defined on the price list) or relative (calculated using a price list adjustment configuration).
PriceAmountDecimalFalseNoThe price of the product variant on this price list. Decimal money amount.
PriceCurrencyCodeStringFalseNoThe price of the product variant on this price list. Currency of the money.
CompareAtPriceAmountDecimalFalseNoThe compare-at price of the product variant on this price list. Decimal money amount.
CompareAtPriceCurrencyCodeStringFalseNoThe compare-at price of the product variant on this price list. Currency of the money.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
CurrencyStringFalseNoThe currency for fixed prices associated with this price list.
FixedPricesCountIntTrueNoThe number of fixed prices on the price list.
NameStringFalseNoThe unique name of the price list, used as a human-readable identifier.
ParentAdjustmentTypeStringFalseNoThe type of price adjustment, such as percentage increase or decrease.
ParentAdjustmentValueDoubleFalseNoThe value of price adjustment, where positive numbers reduce the prices and negative numbers increase them.
ParentSettingsCompareAtModeStringFalseNoThe type of price list adjustment setting for compare at price.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA unique identifier for the media image.
ProductId [KEY]StringTrueProducts.IdNoA globally-unique identifier for the product.
AltTextStringFalseNoA word or phrase to share the nature or contents of a media image.
MediaContentTypeStringTrueNoThe media content type.
HeightIntTrueNoThe original height of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
WidthIntTrueNoThe original width of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
UrlStringFalseNoThe location of the image as a URL.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique identifier.
ProductIdStringFalseProducts.IdNoA globally-unique identifier.
NameStringFalseNoThe product option's name.
PositionIntFalseNoThe product option's position.
ValuesStringTrueNoThe corresponding value to the product option name.
OptionValuesStringTrueNoSimilar to values, option_values returns all the corresponding option value objects to the product option, including values not assigned to any variants.
LinkedMetafieldKeyStringFalseYesThe key of the metafield this option is linked to.
LinkedMetafieldNamespaceStringFalseYesThe namespace of the metafield this option is linked to.
LinkedMetafieldValuesStringFalseYesComma-separated list of values associated with the option.
DeleteVariantStrategyStringFalseYesThe strategy defines which behavior is observed, such as how to handle a situation where deleting an option would result in duplicate variants. If set to 'DEFAULT', the specified Option may only have one corresponding value. If set to 'NON_DESTRUCTIVE', an Option with multiple values can be deleted, but the operation only succeeds if no product variants get deleted. If set to 'POSITION', an Option with multiple values can be deleted. Remaining variants will be deleted, highest position first, in the event of duplicates being detected.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
ProductIdStringFalseNoA globally-unique ID.
ProductOptionIdStringFalseNoA globally-unique ID.
ProductOptionNameStringTrueNoThe product option's name.
Id [KEY]StringTrueNoA globally-unique ID.
NameStringFalseNoValue associated with an option.
LinkedMetafieldValueStringFalseNoMetafield value associated with an option.
HasVariantsBoolTrueNoWhether the product option value has any linked variants.
SwatchColorStringTrueNoThe swatch associated with the product option value. The color representation of the swatch.
SwatchImageIdStringTrueNoThe swatch associated with the product option value. An image representation of the swatch. A globally-unique ID.
VariantStrategyStringFalseYesThe strategy defines which behavior is observed regarding variants. The strategy 'LEAVE_AS_IS' is used by default - variants are not created nor deleted. If set to 'MANAGE', variants are created and deleted according to the option values to add and to delete.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
ProductId [KEY]StringTrueProducts.IdNoThe product associated with the resource feedback.
FeedbackGeneratedAtDatetimeTrueNoThe time when the feedback was generated. Used to help determine whether incoming feedback is outdated compared to existing feedback.
MessagesStringTrueNoThe feedback messages presented to the merchant.
ProductUpdatedAtDatetimeTrueNoThe timestamp of the product associated with the feedback.
StateStringTrueNoConveys the state of the feedback and whether it requires merchant action or not.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique identifier.
LegacyResourceIdLongTrueNoThe ID of the corresponding resource in the REST Admin API.
DescriptionStringTrueNoThe description of the product, complete with HTML formatting.
DescriptionHtmlStringFalseNoThe description of the product, complete with HTML formatting.
TitleStringFalseNoThe title of the product.
HandleStringFalseNoA unique human-friendly string of the product's title.
TagsStringFalseNoA comma separated list of tags associated with the product. Updating 'tags' overwrites any existing tags that were previously added to the product.
StatusStringFalseNoThe product status. This controls visibility across all channels.
VendorStringFalseNoThe name of the product's vendor.
OnlineStorePreviewUrlStringTrueNoThe online store preview URL.
OnlineStoreUrlStringTrueNoThe online store URL for the product.A value of 'null' indicates that the product is not published to the Online Store sales channel.
TracksInventoryBoolTrueNoWhether inventory tracking has been enabled for the product.
TotalInventoryIntTrueNoThe quantity of inventory in stock.
HasOnlyDefaultVariantBoolTrueNoWhether the product has only a single variant with the default option and value.
HasOutOfStockVariantsBoolTrueNoWhether the product has out of stock variants.
HasVariantsThatRequiresComponentsBoolTrueNoWhether at least one of the product variants requires bundle components.
VariantsCountIntTrueNoThe number of variants that are associated with the product.
VariantsCountPrecisionStringTrueNoThe count's precision, or the exactness of the value.
TemplateSuffixStringFalseNoThe theme template used when viewing the product in a store.
GiftCardTemplateSuffixStringFalseNoThe theme template used when viewing the gift card in a store.
IsGiftCardBoolFalseNoWhether the product is a gift card.
PublishedAtDatetimeTrueNoThe date and time when the product was published to the Online Store.
UpdatedAtDatetimeTrueNoThe date and time when the product was last modified.A product's 'updatedAt' value can change for different reasons. For example, if an order is placed for a product that has inventory tracking set up, then the inventory adjustment is counted as an update.
CreatedAtDatetimeTrueNoThe date and time when the product was created.
ProductTypeStringFalseNoThe product type specified by the merchant.
CategoryIdStringTrueNoThe globally-unique ID of the TaxonomyCategory.
CategoryNameStringTrueNoThe name of the taxonomy category. For example, Dog Beds.
CategoryFullNameStringTrueNoThe full name of the taxonomy category. For example, Animals & Pet Supplies > Pet Supplies > Dog Supplies > Dog Beds.
SeoTitleStringFalseNoSEO Title.
SeoDescriptionStringFalseNoSEO Description.
RequiresSellingPlanBoolFalseNoWhether the product can only be purchased with a selling plan (subscription). Products that are sold on subscription ('requiresSellingPlan: true') can be updated only for online stores. If you update a product to be subscription only, then the product is unpublished from all channels except the online store.
SellingPlanGroupsCountIntTrueNoCount of selling plan groups associated with the product.
SellingPlanGroupsCountPrecisionStringTrueNoThe count's precision, or the exactness of the value.
PriceRangeMaxVariantPriceAmountDecimalTrueNoDecimal money amount.
PriceRangeMaxVariantPriceCurrencyCodeStringTrueNoCurrency of the money.
PriceRangeMinVariantPriceAmountDecimalTrueNoDecimal money amount.
PriceRangeMinVariantPriceCurrencyCodeStringTrueNoCurrency of the money.
CompareAtPriceRangeMaxVariantCompareAtPriceAmountDecimalTrueNoDecimal money amount.
CompareAtPriceRangeMaxVariantCompareAtPriceCurrencyCodeStringTrueNoCurrency of the money.
CompareAtPriceRangeMinVariantCompareAtPriceAmountDecimalTrueNoDecimal money amount.
CompareAtPriceRangeMinVariantCompareAtPriceCurrencyCodeStringTrueNoCurrency of the money.
MediaCountIntTrueNoTotal count of media belonging to a product.
MediaCountPrecisionStringTrueNoThe count's precision, or the exactness of the value.
FeaturedMediaIdStringTrueNoA globally-unique ID.
FeaturedMediaAltStringTrueNoA word or phrase to share the nature or contents of a media.
FeaturedMediaContentTypeStringTrueNoThe media content type.
FeaturedMediaStatusStringTrueNoCurrent status of the media.
FeaturedMediaPreviewStatusStringTrueNoCurrent status of the preview image.
FeaturedMediaPreviewImageIdStringTrueNoThe preview image for the media. Returns null until status is READY.
FeaturedMediaPreviewImageAltTextStringTrueNoA word or phrase to share the nature or contents of an image.
FeaturedMediaPreviewImageUrlStringTrueNoThe location of the image as a URL.
FeaturedMediaPreviewImageWidthIntTrueNoThe original width of the image in pixels. Returns null if the image isn't hosted by Shopify.
FeaturedMediaPreviewImageHeightIntTrueNoThe original height of the image in pixels. Returns null if the image isn't hosted by Shopify.
AvailablePublicationsCountIntTrueNoThe number of publications a resource is published to without feedback errors.
AvailablePublicationsCountPrecisionStringTrueNoThe count's precision, or the exactness of the value.
PublishedOnCurrentPublicationBoolTrueNoWhether the resource is published to the app's publication. For example, the resource might be published to the app's online store channel.
ResourcePublicationOnCurrentPublicationAutoPublishBoolTrueNoWhether new products are automatically published to this publication.
ResourcePublicationOnCurrentPublicationIsPublishedBoolTrueNoWhether the resource publication is published. If true, then the resource publication is published to the publication. If false, then the resource publication is staged to be published to the publication.
ResourcePublicationOnCurrentPublicationPublishDateDatetimeTrueNoThe date that the resource publication was or is going to be published to the publication.
ResourcePublicationOnCurrentPublicationPublicationIdStringTrueNoA globally-unique identifier.
ResourcePublicationOnCurrentPublicationPublicationNameStringTrueNoName of the publication.
ResourcePublicationOnCurrentPublicationPublicationSupportsFuturePublishingBoolTrueNoWhether the publication supports future publishing.
ResourcePublicationsCountIntTrueNoThe number of publications that a resource is published to, without feedback errors.
ResourcePublicationsCountPrecisionStringTrueNoThe count's precision, or the exactness of the value.
FeedbackSummaryStringTrueNoSummary of resource feedback pertaining to the resource.
FeedbackDetailsStringTrueNoList of AppFeedback detailing issues regarding a resource.
MetafieldsStringFalseYesThe additional customizable information about the product variant.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique identifier.
LegacyResourceIdLongTrueNoThe ID of the corresponding resource in the REST Admin API.
ProductIdStringFalseProducts.IdNoA globally-unique identifier.
PositionIntTrueNoThe order of the product variant in the list of product variants. The first position in the list is 1.
DisplayNameStringTrueNoDisplay name of the variant, based on product's title + variant's title.
BarcodeStringFalseNoThe value of the barcode associated with the product.
SkuStringTrueNoAn identifier for the product variant in the shop. Required in order to connect to a fulfillment service.
TitleStringTrueNoThe title of the product variant.
RequiresComponentsBoolTrueNoWhether a product variant requires components. The default value is 'false'. If 'true', then the product variant can only be purchased as a parent bundle with components and it will be omitted from channels that don't support bundles.
UpdatedAtDatetimeTrueNoThe date and time when the product variant was last modified.
CreatedAtDatetimeTrueNoThe date and time when the variant was created.
SelectedOptionsStringTrueNoList of product options applied to the variant.
AvailableForSaleBoolTrueNoWhether the product variant is available for sale.
PriceDecimalFalseNoThe price of the product variant in the default shop currency.
CompareAtPriceDecimalFalseNoThe compare-at price of the variant in the default shop currency.
TaxCodeStringFalseNoThe tax code for the product variant.
TaxableBoolFalseNoWhether a tax is charged when the product variant is sold.
SellableOnlineQuantityIntTrueNoThe total sellable quantity of the variant for online channels. This doesn't represent the total available inventory or capture (limitations based on customer location).
SellingPlanGroupsCountIntTrueNoCount of selling plan groups associated with the product variant.
SellingPlanGroupsCountPrecisionStringTrueNoThe count's precision, or the exactness of the value.
DeliveryProfileIdStringTrueNoA globally-unique identifier.
InventoryPolicyStringFalseNoWhether customers are allowed to place an order for the product variant when it's out of stock.
InventoryQuantityIntTrueNoThe total sellable quantity of the variant.
InventoryItemIdStringTrueNoA globally-unique identifier.
InventoryItemUnitCostAmountDecimalFalseNoUnit cost associated with the inventory item.
InventoryItemUnitCostCurrencyCodeStringTrueNoCurrency code of the unit cost associated with the inventory item.
InventoryItemHarmonizedSystemCodeStringFalseNoThe harmonized system code of the inventory item.
InventoryItemMeasurementWeightValueDoubleFalseNoThe weight value using the unit system specified with 'unit'.
InventoryItemMeasurementWeightUnitStringFalseNoThe unit of measurement for 'value'.
InventoryItemRequiresShippingBoolFalseNoWhether the inventory item requires shipping.
InventoryItemTrackedBoolFalseNoWhether inventory levels are tracked for the item.
ImageIdStringTrueNoA unique identifier for the image.
ImageAltTextStringTrueNoA word or phrase to share the nature or contents of an image.
ImageHeightIntTrueNoThe original height of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
ImageWidthIntTrueNoThe original width of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
ImageUrlStringTrueNoThe location of the image as a URL.
MediaIdStringFalseYesThe ID of the media to associate with the variant.
MediaSrcStringFalseYesThe URL of the media to associate with the variant.
InventoryQuantitiesStringFalseYesThe inventory quantities at each location where the variant is stocked. The number of elements in the array of inventory quantities can't exceed the amount specified for the plan.
OptionValuesStringFalseYesThe custom properties that a shop owner uses to define product variants.
MetafieldsStringFalseYesThe additional customizable information about the product variant.
StrategyStringFalseYesThe strategy defines which behavior is observed, such as whether to keep or delete the standalone variant (when product has only a single or default variant) when creating new variants. If set to 'DEFAULT', keep the standalone variant (when product has only a single or default variant) when creating variants. If set to 'REMOVE_STANDALONE_VARIANT', delete the standalone variant (when product has only a single or default variant) when creating new variants.
AllowPartialUpdatesBoolFalseYesWhen partial updates are allowed, valid variant changes may be persisted even if some of the variants updated have invalid data and cannot be persisted. When partial updates are not allowed, any error will prevent all variants from updating.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
LegacyResourceIdStringFalseNoThe ID of the corresponding resource in the REST Admin API.
PublicationId [KEY]StringFalsePublications.IdNoA globally-unique ID.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
ProductId [KEY]StringFalseProducts.IdNoA globally-unique ID.
PublishDateDatetimeFalseNoThe date that the resource publication was or is going to be published to the publication.
IsPublishedBoolFalseNoWhether the resource publication is published.
PublicationId [KEY]StringFalseNoA globally-unique ID.
PublicationNameStringFalseNoName of the publication.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
AutoPublishBoolFalseNoWhether new products are automatically published to this publication.
SupportsFuturePublishingBoolTrueNoWhether the publication supports future publishing.
CatalogIdStringTrueNoA globally-unique ID.
AddAllProductsOperationIdStringTrueNoA globally-unique ID.
AddAllProductsOperationStatusStringTrueNoThe status of this operation.
AddAllProductsOperationProcessedRowCountIntTrueNoThe count of processed rows, summing imported, failed, and skipped rows.
AddAllProductsOperationRowCountCountIntTrueNoEstimated number of rows contained within this background operation.
AddAllProductsOperationRowCountExceedsMaxBoolTrueNoWhether the operation exceeds max number of reportable rows.
CatalogCsvOperationIdStringTrueNoA globally-unique ID.
CatalogCsvOperationStatusStringTrueNoThe status of this operation.
CatalogCsvOperationProcessedRowCountIntTrueNoThe count of processed rows, summing imported, failed, and skipped rows.
CatalogCsvOperationRowCountCountIntTrueNoEstimated number of rows contained within this background operation.
CatalogCsvOperationRowCountExceedsMaxBoolTrueNoWhether the operation exceeds max number of reportable rows.
PublicationResourceOperationIdStringTrueNoA globally-unique ID.
PublicationResourceOperationStatusStringTrueNoThe status of this operation.
PublicationResourceOperationProcessedRowCountIntTrueNoThe count of processed rows, summing imported, failed, and skipped rows.
PublicationResourceOperationRowCountCountIntTrueNoEstimated number of rows contained within this background operation.
PublicationResourceOperationRowCountExceedsMaxBoolTrueNoWhether the operation exceeds max number of reportable rows.
CatalogTypeStringTrueNoFilter publications by catalog type.
DefaultStateStringFalseYesWhether to create an empty publication or prepopulate it with all products.
PublishablesToAddStringFalseYesA simple, comma-separated list of publishable IDs to add. The maximum number of publishables to update simultaneously is 50.
PublishablesToRemoveStringFalseYesA simple, comma-separated list of publishable IDs to remove. The maximum number of publishables to update simultaneously is 50.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
OriginalDutyId [KEY]StringFalseNoA globally-unique ID.
RefundId [KEY]StringFalseRefunds.IdNoA globally-unique ID.
OriginalDutyHarmonizedSystemCodeStringFalseNoThe harmonized system code of the item used in calculating the duty.
OriginalDutyCountryCodeOfOriginStringFalseNoThe ISO 3166-1 alpha-2 country code of the country of origin used in calculating the duty.
AmountSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
AmountSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
AmountSetShopMoneyAmountDecimalFalseNoDecimal money amount.
AmountSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
RefundIdStringFalseNoA globally-unique ID.
LineItemIdStringFalseNoA globally-unique ID.
Id [KEY]StringFalseNoA globally-unique ID.
CountryCodeOfOriginStringFalseNoThe ISO 3166-1 alpha-2 country code of the country of origin used in calculating the duty.
HarmonizedSystemCodeStringFalseNoThe harmonized system code of the item used in calculating the duty.
PricePresentmentMoneyAmountDecimalFalseNoDecimal money amount.
PricePresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
PriceShopMoneyAmountDecimalFalseNoDecimal money amount.
PriceShopMoneyCurrencyCodeStringFalseNoCurrency of the money.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
LineItemIdStringFalseNoA globally-unique ID.
RefundId [KEY]StringFalseRefunds.IdNoA globally-unique ID.
LineItemNameStringFalseNoThe title of the product, optionally appended with the title of the variant (if applicable).
LineItemTitleStringFalseNoThe title of the product at time of order creation.
LineItemVariantTitleStringFalseNoThe title of the variant at time of order creation.
LineItemQuantityIntFalseNoThe number of variant units ordered.
LineItemRestockableBoolFalseNoWhether the line item can be restocked.
LineItemSkuStringFalseNoThe variant SKU number.
LineItemTaxableBoolFalseNoWhether the variant is taxable.
LineItemVendorStringFalseNoThe name of the vendor who made the variant.
LineItemCurrentQuantityIntFalseNoThe line item's quantity, minus the removed quantity.
LineItemMerchantEditableBoolFalseNoWhether the line item can be edited or not.
LineItemRefundableQuantityIntFalseNoThe line item's quantity, minus the removed quantity.
LineItemNonFulfillableQuantityIntFalseNoThe total number of units that can't be fulfilled. For example, if items have been refunded, or the item is not something that can be fulfilled, like a tip. Please see the object for more fulfillment details.
LineItemRequiresShippingBoolFalseNoWhether physical shipping is required for the variant.
LineItemUnfulfilledQuantityIntFalseNoThe number of units not yet fulfilled.
LineItemImageIdStringFalseNoA unique ID for the image.
LineItemImageWidthIntFalseNoThe original width of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
LineItemImageAltTextStringFalseNoA word or phrase to share the nature or contents of an image.
LineItemImageHeightIntFalseNoThe original height of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
LineItemImageUrlStringFalseNoThe location of the image as a URL.
LineItemProductIdStringFalseNoA globally-unique ID.
LineItemVariantIdStringFalseNoA globally-unique ID.
LineItemSellingPlanSellingPlanIdStringFalseNoThe ID of the selling plan associated with the line item.
LineItemStaffMemberIdStringFalseNoA globally-unique ID.(This column is available only with a ShopifyPlus subscription)
QuantityIntFalseNoThe quantity of a refunded line item.
RestockedBoolFalseNoWhether the refunded line item was restocked. Not applicable in the context of a SuggestedRefund.
RestockTypeStringFalseNoThe type of restock for the refunded line item.
LocationIdStringFalseNoA globally-unique ID.
PriceSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
PriceSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
PriceSetShopMoneyAmountDecimalFalseNoDecimal money amount.
PriceSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
SubtotalSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
SubtotalSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
SubtotalSetShopMoneyAmountDecimalFalseNoDecimal money amount.
SubtotalSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
TotalTaxSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
TotalTaxSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
TotalTaxSetShopMoneyAmountDecimalFalseNoDecimal money amount.
TotalTaxSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
LineItemContractIdStringFalseNoA globally-unique ID.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoGlobally unique identifier.
LegacyResourceIdStringTrueNoThe ID of the corresponding resource in the REST Admin API.
OrderIdStringTrueOrders.IdNoA globally-unique ID.
NoteStringTrueNoThe optional note associated with the refund.
CreatedAtDatetimeTrueNoThe date and time when the refund was created.
UpdatedAtDatetimeTrueNoThe date and time when the refund was updated.
ReturnIdStringTrueNoA globally-unique ID.
StaffMemberIdStringTrueNoA globally-unique ID.(This column is available only with a ShopifyPlus subscription)
TotalRefundedSetPresentmentMoneyAmountDecimalTrueNoDecimal money amount.
TotalRefundedSetPresentmentMoneyCurrencyCodeStringTrueNoCurrency of the money.
TotalRefundedSetShopMoneyAmountDecimalTrueNoDecimal money amount.
TotalRefundedSetShopMoneyCurrencyCodeStringTrueNoCurrency of the money.
RefundLineItemsStringTrueNoThe list of the line items in the draft order.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
TransactionIdStringFalseRefundTransactions.IdNoA globally-unique ID.
RefundIdStringFalseRefunds.IdNoA globally-unique ID.
RateNameStringFalseNoName of the credit card rate.
FlatFeeNameStringFalseNoName of the credit card flat fee.
RateDecimalFalseNoPercentage charge.
TypeStringFalseNoName of the type of fee.
AmountAmountDecimalFalseNoDecimal money amount.
AmountCurrencyCodeStringFalseNoCurrency of the money.
FlatFeeAmountDecimalFalseNoDecimal money amount.
FlatFeeCurrencyCodeStringFalseNoCurrency of the money.
TaxAmountAmountDecimalFalseNoDecimal money amount.
TaxAmountCurrencyCodeStringFalseNoCurrency of the money.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
ResourceId [KEY]StringFalseRefunds.IdNoA globally-unique ID.
PaymentIdStringFalseNoThe payment ID associated with the transaction.
ParentTransactionIdStringFalseNoThe associated parent transaction, for example the authorization of a capture.
AccountNumberStringFalseNoThe masked account number associated with the payment method.
GatewayStringFalseNoThe payment gateway used to process the transaction.
KindStringFalseNoThe kind of transaction.
StatusStringFalseNoThe status of this transaction.
TestBoolFalseNoWhether the transaction is a test transaction.
AuthorizationCodeStringFalseNoAuthorization code associated with the transaction.
ErrorCodeStringFalseNoA standardized error code, independent of the payment provider.
FormattedGatewayStringFalseNoThe human-readable payment gateway name used to process the transaction.
ManuallyCapturableBoolFalseNoWhether the transaction can be manually captured.
MultiCapturableBoolFalseNoWhether the transaction can be captured multiple times.
ProcessedAtDatetimeFalseNoDate and time when the transaction was processed.
ReceiptJsonStringFalseNoThe transaction receipt that the payment gateway attaches to the transaction. The value of this field depends on which payment gateway processed the transaction.
SettlementCurrencyStringFalseNoThe settlement currency.
AuthorizationExpiresAtDatetimeFalseNoThe time when the authorization expires. This field is available only to stores on a Shopify Plus plan and is populated only for Shopify Payments authorizations.
SettlementCurrencyRateDecimalFalseNoThe rate used when converting the transaction amount to settlement currency.
CreatedAtDatetimeFalseNoDate and time when the transaction was created.
CardPaymentDetailsNameStringFalseNoThe holder of the credit card.
CardPaymentDetailsBinStringFalseNoThe issuer identification number (IIN), formerly known as bank identification number (BIN) of the customer's credit card. This is made up of the first few digits of the credit card number.
CardPaymentDetailsCompanyStringFalseNoThe name of the company that issued the customer's credit card.
CardPaymentDetailsNumberStringFalseNoThe customer's credit card number, with most of the leading digits redacted.
CardPaymentDetailsWalletStringFalseNoDigital wallet used for the payment.
CardPaymentDetailsExpirationMonthIntFalseNoThe month in which the used credit card expires.
CardPaymentDetailsExpirationYearIntFalseNoThe year in which the used credit card expires.
CardPaymentDetailsAvsResultCodeStringFalseNoThe response code from the address verification system (AVS). The code is always a single letter.
CardPaymentDetailsCvvResultCodeStringFalseNoThe response code from the credit card company indicating whether the customer entered the card security code, or card verification value, correctly. The code is a single letter or empty string.
PaymentIconIdStringFalseNoA unique ID for the image.
PaymentIconWidthIntFalseNoThe original width of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
PaymentIconAltTextStringFalseNoA word or phrase to share the nature or contents of an image.
PaymentIconHeightIntFalseNoThe original height of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
AmountSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
AmountSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
AmountSetShopMoneyAmountDecimalFalseNoDecimal money amount.
AmountSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
MaximumRefundableV2AmountDecimalFalseNoDecimal money amount.
MaximumRefundableV2CurrencyCodeStringFalseNoCurrency of the money.
ShopifyPaymentsSetExtendedAuthorizationSetExtendedAuthorizationExpiresAtDatetimeFalseNoThe time after which the extended authorization expires. After the expiry, the merchant is unable to capture the payment.
ShopifyPaymentsSetExtendedAuthorizationSetStandardAuthorizationExpiresAtDatetimeFalseNoThe time after which capture will incur an additional fee.
ShopifyPaymentsSetRefundSetAcquirerReferenceNumberStringFalseNoThe acquirer reference number (ARN) code generated for Visa/Mastercard transactions.
TotalUnsettledSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
TotalUnsettledSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
TotalUnsettledSetShopMoneyAmountDecimalFalseNoDecimal money amount.
TotalUnsettledSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
ResourceIdStringFalseReturns.IdNoA globally-unique ID.
NameStringFalseNoThe title of the product, optionally appended with the title of the variant (if applicable).
TitleStringFalseNoThe title of the product at time of order creation.
VariantTitleStringFalseNoThe title of the variant at time of order creation.
VariantIdStringFalseNoA globally-unique ID.
ProductIdStringFalseNoA globally-unique ID.
SellingPlanSellingPlanIdStringFalseNoThe ID of the selling plan associated with the line item.
QuantityIntFalseNoThe number of variant units ordered.
RestockableBoolFalseNoWhether the line item can be restocked.
SkuStringFalseNoThe variant SKU number.
TaxableBoolFalseNoWhether the variant is taxable.
VendorStringFalseNoThe name of the vendor who made the variant.
CurrentQuantityIntFalseNoThe line item's quantity, minus the removed quantity.
MerchantEditableBoolFalseNoWhether the line item can be edited or not.
RefundableQuantityIntFalseNoThe line item's quantity, minus the removed quantity.
RequiresShippingBoolFalseNoWhether physical shipping is required for the variant.
UnfulfilledQuantityIntFalseNoThe number of units not yet fulfilled.
NonFulfillableQuantityIntFalseNoThe total number of units that can't be fulfilled. For example, if items have been refunded, or the item is not something that can be fulfilled, like a tip. Please see the object for more fulfillment details.
IsGiftCardBoolFalseNoWhether the line item represents the purchase of a gift card.
DiscountedTotalSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
DiscountedTotalSetPresentmentMoneyAmountWithCodeDiscountsDecimalFalseNoDecimal money amount.
DiscountedTotalSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
DiscountedTotalSetShopMoneyAmountDecimalFalseNoDecimal money amount.
DiscountedTotalSetShopMoneyAmountWithCodeDiscountsDecimalFalseNoDecimal money amount.
DiscountedTotalSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
DiscountedUnitPriceSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
DiscountedUnitPriceSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
DiscountedUnitPriceSetShopMoneyAmountDecimalFalseNoDecimal money amount.
DiscountedUnitPriceSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
ImageIdStringFalseNoA unique ID for the image.
ImageWidthIntFalseNoThe original width of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
ImageAltTextStringFalseNoA word or phrase to share the nature or contents of an image.
ImageHeightIntFalseNoThe original height of the image in pixels. Returns 'null' if the image is not hosted by Shopify.
ImageUrlStringFalseNoThe location of the image as a URL.
OriginalTotalSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
OriginalTotalSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
OriginalTotalSetShopMoneyAmountDecimalFalseNoDecimal money amount.
OriginalTotalSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
OriginalUnitPriceSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
OriginalUnitPriceSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
OriginalUnitPriceSetShopMoneyAmountDecimalFalseNoDecimal money amount.
OriginalUnitPriceSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
TotalDiscountSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
TotalDiscountSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
TotalDiscountSetShopMoneyAmountDecimalFalseNoDecimal money amount.
TotalDiscountSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
UnfulfilledDiscountedTotalSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
UnfulfilledDiscountedTotalSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
UnfulfilledDiscountedTotalSetShopMoneyAmountDecimalFalseNoDecimal money amount.
UnfulfilledDiscountedTotalSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
UnfulfilledOriginalTotalSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
UnfulfilledOriginalTotalSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
UnfulfilledOriginalTotalSetShopMoneyAmountDecimalFalseNoDecimal money amount.
UnfulfilledOriginalTotalSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
ReturnId [KEY]StringFalseReturns.IdNoA globally-unique ID.
QuantityIntFalseNoThe quantity being returned.
CustomerNoteStringFalseNoA note from the customer that describes the item to be returned. Maximum length: 300 characters.
RefundableQuantityIntFalseNoThe quantity that can be refunded.
RefundedQuantityIntFalseNoThe quantity that was refunded.
ReturnReasonStringFalseNoThe reason for returning the item.
ReturnReasonNoteStringFalseNoAdditional information about the reason for the return. Maximum length: 255 characters.
TotalWeightUnitStringFalseNoThe unit of measurement for value.
TotalWeightValueDoubleFalseNoThe weight value using the unit system specified with unit.
WithCodeDiscountedTotalPriceSetPresentmentMoneyAmountDecimalFalseNoDecimal money amount.
WithCodeDiscountedTotalPriceSetPresentmentMoneyCurrencyCodeStringFalseNoCurrency of the money.
WithCodeDiscountedTotalPriceSetShopMoneyAmountDecimalFalseNoDecimal money amount.
WithCodeDiscountedTotalPriceSetShopMoneyCurrencyCodeStringFalseNoCurrency of the money.
FulfillmentLineItemIdStringFalseNoA globally-unique ID.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
ReturnId [KEY]StringFalseReturns.IdNoA globally-unique ID.
CustomerNoteStringFalseNoA note from the customer that describes the item to be returned. Maximum length: 300 characters.
QuantityIntFalseNoThe quantity being returned.
RefundableQuantityIntFalseNoThe quantity that can be refunded.
RefundedQuantityIntFalseNoThe quantity that was refunded.
ReturnReasonStringFalseNoThe reason for returning the item.
ReturnReasonNoteStringFalseNoAdditional information about the reason for the return. Maximum length: 255 characters.
UnitPriceAmountDecimalFalseNoDecimal money amount.
UnitPriceCurrencyCodeStringFalseNoCurrency of the money.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
OrdersIdStringTrueOrders.IdNoA globally-unique ID.
NameStringTrueNoThe name of the return.
StatusStringTrueNoThe status of the return.
TotalQuantityIntTrueNoThe sum of all line item quantities for the return.
DeclineReasonStringTrueNoThe reason the customer's return request was declined.
DeclineNoteStringTrueNoThe notification message sent to the customer about their declined return request. Maximum length: 500 characters.
ReturnLineItemsStringTrueNoThe list of the line items in the return.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
LegacyResourceIdStringTrueNoThe ID of the corresponding resource in the REST Admin API.
CacheBoolFalseNoWhether the Shopify CDN can cache and serve the script tag. If 'true', then the script will be cached and served by the CDN. The cache expires 15 minutes after the script tag is successfully returned. If 'false', then the script will be served as is.
SrcStringFalseNoThe URL to the remote script.
DisplayScopeStringFalseNoThe page or pages on the online store that the script should be included.
CreatedAtDatetimeTrueNoThe date and time when the script tag was created.
UpdatedAtDatetimeTrueNoThe date and time when the script tag was last updated.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
SegmentFilterQueryName [KEY]StringFalseNoThe query name of the filter.
QueryName [KEY]StringFalseNoThe query name of the parameter.
ParameterTypeStringFalseNoThe type of the parameter.
OptionalBoolFalseNoWhether the parameter is optional.
AcceptsMultipleValuesBoolFalseNoWhether the parameter accepts a list of values.
LocalizedNameStringFalseNoThe localized name of the parameter.
LocalizedDescriptionStringFalseNoThe localized description of the parameter.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
QueryName [KEY]StringFalseNoThe query name of the filter.
MultiValueBoolFalseNoWhether a file can have multiple values for a single customer.
LocalizedNameStringFalseNoThe localized name of the filter.
ReturnValueTypeStringFalseNoThe return value type for an event segment filter.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
NameStringFalseNoThe name of the segment.
QueryStringFalseNoA precise definition of the segment. The definition is composed of a combination of conditions on facts about customers.
CreationDateDatetimeTrueNoThe date and time when the segment was added to the store.
LastEditDateDatetimeTrueNoThe date and time when the segment was last updated.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
AppIdStringFalseNoThe ID for app, exposed in Liquid and product JSON.
NameStringFalseNoThe buyer-facing label of the selling plan group.
DescriptionStringFalseNoThe merchant-facing description of the selling plan group.
OptionsStringFalseNoThe values of all options available on the selling plan group. Selling plans are grouped together in Liquid when they are created by the same app, and have the same 'selling_plan_group. name' and 'selling_plan_group. options' values.
PositionIntFalseNoThe relative position of the selling plan group for display.
SummaryStringTrueNoA summary of the policies associated to the selling plan group.
MerchantCodeStringFalseNoThe merchant-facing label of the selling plan group.
ProductsCountIntTrueNoA count of products associated to the selling plan group.
ProductsCountPrecisionStringTrueNoThe count's precision, or the exactness of the value.
CreatedAtDatetimeTrueNoThe date and time when the selling plan group was created.
SellingPlansToCreateStringFalseNoList of selling plans to create.
SellingPlansToUpdateStringFalseNoList of selling plans to update.
SellingPlansToDeleteStringFalseYesList of selling plans to delete as a simple, comma-separated list.
ProductIdsStringFalseYesThe IDs of the Products to add to the Selling Plan Group as a simple, comma-separated list.
ProductVariantIdsStringFalseYesThe IDs of the Variants to add to the Selling Plan Group as a simple, comma-separated list.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
SellingPlanGroupIdStringFalseSellingPlanGroups.IdNoA globally-unique ID.
NameStringFalseNoA customer-facing description of the selling plan. If your store supports multiple currencies, then don't include country-specific pricing content, such as 'Buy monthly, get 10$ CAD off'. This field won't be converted to reflect different currencies.
CategoryStringFalseNoThe category used to classify the selling plan for reporting purposes.
DescriptionStringFalseNoBuyer facing string which describes the selling plan commitment.
OptionsStringFalseNoThe values of all options available on the selling plan. Selling plans are grouped together in Liquid when they are created by the same app, and have the same 'selling_plan_group. name' and 'selling_plan_group. options' values.
PositionIntFalseNoRelative position of the selling plan for display. A lower position will be displayed before a higher position.
CreatedAtDatetimeFalseNoThe date and time when the selling plan was created.
InventoryPolicyReserveStringFalseNoWhen to reserve inventory for the order.
FixedBillingPolicyCheckoutChargeTypeStringFalseNoThe charge type for the checkout charge.
FixedBillingPolicyCheckoutChargeValueAmountDecimalFalseNoThe charge value for the checkout charge. Decimal money amount.
FixedBillingPolicyCheckoutChargeValueCurrencyCodeStringFalseNoThe charge value for the checkout charge. Currency of the money.
FixedBillingPolicyCheckoutChargeValuePercentageDoubleFalseNoThe charge value for the checkout charge. The percentage value of the price used for checkout charge.
FixedBillingPolicyRemainingBalanceChargeExactTimeDatetimeFalseNoThe exact time when to capture the full payment.
FixedBillingPolicyRemainingBalanceChargeTimeAfterCheckoutStringFalseNoThe period after remaining_balance_charge_trigger, before capturing the full payment. Expressed as an ISO8601 duration.
FixedBillingPolicyRemainingBalanceChargeTriggerStringFalseNoWhen to capture payment for amount due.
RecurringBillingPolicyAnchorsStringFalseNoSpecific anchor dates upon which the billing interval calculations should be made. Aggregate value.
RecurringBillingPolicyCreatedAtDatetimeFalseNoThe date and time when the selling plan billing policy was created.
RecurringBillingPolicyIntervalStringFalseNoThe billing frequency, it can be either: day, week, month or year.
RecurringBillingPolicyIntervalCountIntFalseNoThe number of intervals between billings.
RecurringBillingPolicyMaxCyclesIntFalseNoMaximum number of billing iterations.
RecurringBillingPolicyMinCyclesIntFalseNoMinimum number of billing iterations.
FixedDeliveryPolicyAnchorsStringFalseNoThe specific anchor dates upon which the delivery interval calculations should be made. Aggregate value.
FixedDeliveryPolicyCutoffIntFalseNoA buffer period for orders to be included in next fulfillment anchor.
FixedDeliveryPolicyFulfillmentExactTimeDatetimeFalseNoThe date and time when the fulfillment should trigger.
FixedDeliveryPolicyFulfillmentTriggerStringFalseNoWhat triggers the fulfillment. The value must be one of ANCHOR, ASAP, EXACT_TIME, or UNKNOWN.
FixedDeliveryPolicyIntentStringFalseNoWhether the delivery policy is merchant or buyer-centric. Buyer-centric delivery policies state the time when the buyer will receive the goods. Merchant-centric delivery policies state the time when the fulfillment should be started. Currently, only merchant-centric delivery policies are supported.
FixedDeliveryPolicyPreAnchorBehaviorStringFalseNoThe fulfillment or delivery behavior of the first fulfillment when the order is placed before the anchor. The default value for this field is ASAP.
RecurringDeliveryPolicyAnchorsStringFalseNoThe specific anchor dates upon which the delivery interval calculations should be made. Aggregate value.
RecurringDeliveryPolicyCreatedAtDatetimeFalseNoThe date and time when the selling plan delivery policy was created.
RecurringDeliveryPolicyCutoffIntFalseNoNumber of days which represent a buffer period for orders to be included in a cycle.
RecurringDeliveryPolicyIntentStringFalseNoWhether the delivery policy is merchant or buyer-centric. Buyer-centric delivery policies state the time when the buyer will receive the goods. Merchant-centric delivery policies state the time when the fulfillment should be started. Currently, only merchant-centric delivery policies are supported.
RecurringDeliveryPolicyIntervalStringFalseNoThe delivery frequency, it can be either: day, week, month or year.
RecurringDeliveryPolicyIntervalCountIntFalseNoThe number of intervals between deliveries.
RecurringDeliveryPolicyPreAnchorBehaviorStringFalseNoThe fulfillment or delivery behavior of the first fulfillment when the order is placed before the anchor. The default value for this field is ASAP.
FixedPricingPoliciesStringFalseNoRepresents fixed selling plan pricing policies associated to the selling plan. Aggregate value.
RecurringPricingPoliciesStringFalseNoRepresents recurring selling plan pricing policies associated to the selling plan. Aggregate value.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
NameStringFalseNoThe shop's name.
RichTextEditorUrlStringFalseNoThe URL of the rich text editor that can be used for mobile devices.
DescriptionStringFalseNoThe shop's meta description used in search engine results.
EmailStringFalseNoThe shop owner's email address. Shopify will use this email address to communicate with the shop owner.
UrlStringFalseNoThe URL of the shop's online store.
ContactEmailStringFalseNoThe public-facing contact email address for the shop. Customers will use this email to communicate with the shop owner.
CurrencyCodeStringFalseNoThe three letter code for the currency that the shop sells in.
CustomerAccountsStringFalseNoWhether customer accounts are required, optional, or disabled for the shop.
IanaTimezoneStringFalseNoThe shop's time zone as defined by the IANA.
MyshopifyDomainStringFalseNoThe shop's . myshopify. com domain name.
PublicationsCountIntFalseNoThe number of publications for the shop.
PublicationsCountPrecisionStringFalseNoThe count's precision, or the exactness of the value.
SetupRequiredBoolFalseNoWhether the shop has outstanding setup steps.
TaxShippingBoolFalseNoWhether the shop charges taxes for shipping.
TaxesIncludedBoolFalseNoWhether applicable taxes are included in the shop's product prices.
TimezoneAbbreviationStringFalseNoThe shop's time zone abbreviation.
TimezoneOffsetStringFalseNoThe shop's time zone offset.
UnitSystemStringFalseNoThe shop's unit system for weights and measures.
WeightUnitStringFalseNoThe shop's primary unit of weight for products and shipping.
CheckoutApiSupportedBoolFalseNoSpecifies whether the shop supports checkouts via Checkout API.
EnabledPresentmentCurrenciesStringFalseNoThe presentment currencies enabled for the shop.
ShipsToCountriesStringFalseNoThe list of countries that the shop ships to.
TimezoneOffsetMinutesIntFalseNoThe shop's time zone offset expressed as a number of minutes.
TransactionalSmsDisabledBoolFalseNoWhether transactional SMS sent by Shopify have been disabled for a shop.
OrderNumberFormatPrefixStringFalseNoThe prefix that appears before order numbers.
OrderNumberFormatSuffixStringFalseNoThe suffix that appears after order numbers.
BillingAddressIdStringFalseNoA globally-unique ID.
BillingAddressCoordinatesValidatedBoolFalseNoWhether the address coordinates are valid.
BillingAddressAddress1StringFalseNoThe first line of the address. Typically the street address or PO Box number.
BillingAddressAddress2StringFalseNoThe second line of the address. Typically the number of the apartment, suite, or unit.
BillingAddressCityStringFalseNoThe name of the city, district, village, or town.
BillingAddressCompanyStringFalseNoThe name of the company or organization.
BillingAddressCountryStringFalseNoThe name of the country.
BillingAddressLatitudeDoubleFalseNoThe latitude coordinate of the address.
BillingAddressLongitudeDoubleFalseNoThe longitude coordinate of the address.
BillingAddressPhoneStringFalseNoA phone number associated with the address. Formatted using E. 164 standard. For example, +16135551111.
BillingAddressProvinceStringFalseNoThe region of the address, such as the province, state, or district.
BillingAddressZipStringFalseNoThe zip or postal code of the address.
BillingAddressFormattedAreaStringFalseNoA comma-separated list of the values for city, province, and country.
BillingAddressProvinceCodeStringFalseNoThe two-letter code for the region. For example, ON.
BillingAddressCountryCodeV2StringFalseNoThe two-letter code for the country of the address. For example, US.
CountriesInShippingZonesCountryCodesStringFalseNoThe list of all the countries from all the combined shipping zones.
CountriesInShippingZonesIncludeRestOfWorldBoolFalseNoWhether 'Rest of World' has been defined in any of the shipping zones.
CurrencyFormatsMoneyFormatStringFalseNoMoney without currency in HTML.
CurrencyFormatsMoneyInEmailsFormatStringFalseNoMoney without currency in emails.
CurrencyFormatsMoneyWithCurrencyFormatStringFalseNoMoney with currency in HTML.
CurrencyFormatsMoneyWithCurrencyInEmailsFormatStringFalseNoMoney with currency in emails.
FeaturesInternationalPriceOverridesBoolFalseNoWhether a shop can enable international price overrides.
FeaturesBrandingStringFalseNoThe branding of the shop, which influences its look and feel in the Shopify admin.
FeaturesCaptchaBoolFalseNoWhether a shop's online store can have CAPTCHA protection.
FeaturesReportsBoolFalseNoWhether a shop has access to all reporting features.
FeaturesStorefrontBoolFalseNoWhether a shop has an online store.
FeaturesAvalaraAvataxBoolFalseNoWhether a shop has access to Avalara AvaTax.
FeaturesDynamicRemarketingBoolFalseNoWhether a shop has access to the Google Analytics dynamic remarketing feature.
FeaturesGiftCardsBoolFalseNoWhether a shop can create gift cards.
FeaturesLiveViewBoolFalseNoWhether to show the Live View metrics in the Shopify admin. Live view is hidden from merchants that are on a trial or don't have a storefront.
FeaturesSellsSubscriptionsBoolFalseNoWhether a shop has ever had subscription products.
FeaturesShowMetricsBoolFalseNoWhether to show metrics in the Shopify admin. Metrics are hidden for new merchants until they become meaningful.
FeaturesEligibleForSubscriptionsBoolFalseNoWhether a shop is configured properly to sell subscriptions.
FeaturesHarmonizedSystemCodeBoolFalseNoWhether a shop displays Harmonized System codes on products. This is used for customs when shipping internationally.
FeaturesInternationalPriceRulesBoolFalseNoWhether a shop can enable international price rules.
FeaturesEligibleForSubscriptionMigrationBoolFalseNoWhether a shop can be migrated to use Shopify subscriptions.
FeaturesLegacySubscriptionGatewayEnabledBoolFalseNoWhether a shop has enabled a legacy subscription gateway to handle older subscriptions.
FeaturesPaypalExpressSubscriptionGatewayStatusStringFalseNoWhether a shop is configured to sell subscriptions with PayPal Express.
PendingOrdersCountIntFalseNoThe count of elements.
PendingOrdersPrecisionStringFalseNoThe count's precision, or the exactness of the value.
PaymentSettingsSupportedDigitalWalletsStringFalseNoList of the digital wallets which the shop supports.
PlanDisplayNameStringFalseNoThe name of the shop's billing plan.
PlanPartnerDevelopmentBoolFalseNoWhether the shop is a partner development shop for testing purposes.
PlanShopifyPlusBoolFalseNoWhether the shop has a Shopify Plus subscription.
PrimaryDomainIdStringFalseNoA globally-unique ID.
PrimaryDomainHostStringFalseNoThe host name of the domain. For example, 'example. com'.
PrimaryDomainUrlStringFalseNoThe URL of the domain (for example, 'https: //example. com').
PrimaryDomainSslEnabledBoolFalseNoWhether SSL is enabled.
PrimaryDomainLocalizationCountryStringFalseNoThe ISO code for the country assigned to the domain. For example, 'CA' or '*' for a domain set to 'Rest of world'.
PrimaryDomainLocalizationAlternateLocalesStringFalseNoThe ISO codes for the domain's alternate locales. For example, '['en']'.
PrimaryDomainLocalizationDefaultLocaleStringFalseNoThe ISO code for the domain's default locale. For example, 'en'.
PrimaryDomainMarketWebPresenceIdStringFalseNoA globally-unique ID.
PrimaryDomainMarketWebPresenceAlternateLocalesStringFalseNoThe ISO codes for the alternate locales. When a domain is used, these locales will be available as language-specific subfolders. For example, if English is an alternate locale, and 'example. ca' is the market's domain, then 'example. ca/en' will load in English.
PrimaryDomainMarketWebPresenceDefaultLocaleStringFalseNoThe ShopLocale object for the default locale. The locale ISO code.
PrimaryDomainMarketWebPresenceDefaultLocaleMarketWebPresencesIdStringFalseNoThe ShopLocale object for the default locale. The market web presences that use the locale.
PrimaryDomainMarketWebPresenceDefaultLocaleNameStringFalseNoThe ShopLocale object for the default locale. The human-readable locale name.
PrimaryDomainMarketWebPresenceDefaultLocalePrimaryBoolFalseNoThe ShopLocale object for the default locale. Whether the locale is the default locale for the shop.
PrimaryDomainMarketWebPresenceDefaultLocalePublishedBoolFalseNoThe ShopLocale object for the default locale. Whether the locale is visible to buyers.
PrimaryDomainMarketWebPresenceSubfolderSuffixStringFalseNoThe market-specific suffix of the subfolders defined by the web presence. Example: in '/en-us' the subfolder suffix is 'us'. This field will be null if 'domain' isn't null.
ResourceLimitsLocationLimitIntFalseNoMaximum number of locations allowed.
ResourceLimitsMaxProductOptionsIntFalseNoMaximum number of product options allowed.
ResourceLimitsMaxProductVariantsIntFalseNoThe maximum number of variants allowed per product.
ResourceLimitsRedirectLimitReachedBoolFalseNoWhether the shop has reached the limit of the number of URL redirects it can make for resources.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
ActivatedBoolFalseNoWhether the Shopify Payments setup is completed.
CountryStringFalseNoThe Shopify Payments account country.
OnboardableBoolFalseNoWhether the Shopify Payments account can be onboarded.
DefaultCurrencyStringFalseNoThe default payout currency for the Shopify Payments account.
PayoutStatementDescriptorStringFalseNoThe descriptor used for payouts. The descriptor appears on a merchant's bank statement when they receive a payout.
FraudSettingsDeclineChargeOnAvsFailureBoolFalseNoDecline a charge if there is an AVS failure.
FraudSettingsDeclineChargeOnCvcFailureBoolFalseNoDecline a charge if there is an CVC failure.
NotificationSettingsPayoutsBoolFalseNoReceive email notifications when new payouts are sent or payouts fail.
PayoutScheduleIntervalStringFalseNoThe interval at which payouts are sent to the connected bank account.
PayoutScheduleMonthlyAnchorIntFalseNoThe day of the month funds will be paid out. The value can be any day of the month from the 1st to the 31st. If the payment interval is set to monthly, this value will be used. Payouts scheduled between 29-31st of the month are sent on the last day of shorter months.
PayoutScheduleWeeklyAnchorStringFalseNoThe day of the week funds will be paid out. The value can be any weekday from Monday to Friday. If the payment interval is set to weekly, this value will be used.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
ShopifyPaymentsAccountIdStringFalseShopifyPaymentsAccount.IdNoA globally-unique ID.
AmountDecimalFalseNoDecimal money amount.
CurrencyCode [KEY]StringFalseNoCurrency of the money.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Link [KEY]StringFalseNoThe link to the adjustment order.
NameStringFalseNoThe name of the adjustment order.
AmountDecimalFalseNoThe amount of the adjustment order. Decimal money amount.
AmountCurrencyCodeStringFalseNoThe amount of the adjustment order. Currency of the money.
ShopifyPaymentsAccountBalanceTransactionId [KEY]StringFalseNoA globally-unique ID.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
ShopifyPaymentsAccountIdStringFalseShopifyPaymentsAccount.IdNoA globally-unique ID.
NetAmountDecimalFalseNoThe net amount contributing to the merchant's balance. Decimal money amount.
NetCurrencyCodeStringFalseNoThe net amount contributing to the merchant's balance. Currency of the money.
TransactionDateDatetimeFalseNoThe date and time when the balance transaction was processed.
SourceTypeStringFalseNoThe source type of the balance transaction.
TypeStringFalseNoThe type of the transaction.
TestBoolFalseNoWhether the transaction was created in test mode.
AmountDecimalFalseNoDecimal money amount.
AmountCurrencyCodeStringFalseNoCurrency of the money.
FeeAmountDecimalFalseNoDecimal money amount.
FeeCurrencyCodeStringFalseNoCurrency of the money.
AssociatedOrderIdStringFalseNoThe ID of the associated order.
AssociatedOrderNameStringFalseNoThe name of the associated order.
AssociatedPayoutIdStringFalseNoThe ID of the payout associated with the balance transaction.
AssociatedPayoutStatusStringFalseNoThe status of the payout associated with the balance transaction.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
ShopifyPaymentsAccountIdStringFalseShopifyPaymentsAccount.IdNoA globally-unique ID.
BankNameStringFalseNoThe name of the bank.
CountryStringFalseNoThe country of the bank.
CurrencyStringFalseNoThe currency of the bank account.
StatusStringFalseNoThe status of the bank account.
AccountNumberStringFalseNoThe account number of the bank account.
RoutingNumberStringFalseNoThe routing number of the bank account.
AccountNumberLastDigitsStringFalseNoThe last digits of the account number (the rest is redacted).
CreatedAtDatetimeFalseNoThe date that the bank account was created.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
LegacyResourceIdStringFalseNoThe ID of the corresponding resource in the REST Admin API.
ShopifyPaymentsAccountIdStringFalseShopifyPaymentsAccount.IdNoA globally-unique ID.
EvidenceDueByDateFalseNoThe deadline for evidence submission.
EvidenceSentOnDateFalseNoThe date when evidence was sent. Returns null if evidence has not yet been sent.
StatusStringFalseNoThe current state of the dispute.
TypeStringFalseNoIndicates if this dispute is still in the inquiry phase or has turned into a chargeback.
FinalizedOnDateFalseNoThe date when this dispute was resolved. Returns null if the dispute is not yet resolved.
InitiatedAtDatetimeFalseNoThe date when this dispute was initiated.
AmountAmountDecimalFalseNoDecimal money amount.
AmountCurrencyCodeStringFalseNoCurrency of the money.
OrderIdStringFalseNoA globally-unique ID.
ReasonDetailsReasonStringFalseNoThe reason for the dispute provided by the cardholder's banks.
ReasonDetailsNetworkReasonCodeStringFalseNoThe raw code provided by the payment network.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
LegacyResourceIdStringFalseNoThe ID of the corresponding resource in the REST Admin API.
ShopifyPaymentsAccountIdStringFalseShopifyPaymentsAccount.IdNoA globally-unique ID.
StatusStringFalseNoThe transfer status of the payout.
IssuedAtDatetimeFalseNoThe exact time when the payout was issued. The payout only contains balance transactions that were available at this time.
TransactionTypeStringFalseNoThe direction of the payout.
BankAccountIdStringFalseNoA globally-unique ID.
NetAmountDecimalFalseNoDecimal money amount.
NetCurrencyCodeStringFalseNoCurrency of the money.
SummaryAdjustmentsFeeAmountDecimalFalseNoDecimal money amount.
SummaryAdjustmentsFeeCurrencyCodeStringFalseNoCurrency of the money.
SummaryAdjustmentsGrossAmountDecimalFalseNoDecimal money amount.
SummaryAdjustmentsGrossCurrencyCodeStringFalseNoCurrency of the money.
SummaryChargesFeeAmountDecimalFalseNoDecimal money amount.
SummaryChargesFeeCurrencyCodeStringFalseNoCurrency of the money.
SummaryChargesGrossAmountDecimalFalseNoDecimal money amount.
SummaryChargesGrossCurrencyCodeStringFalseNoCurrency of the money.
SummaryRefundsFeeAmountDecimalFalseNoDecimal money amount.
SummaryRefundsFeeCurrencyCodeStringFalseNoCurrency of the money.
SummaryRefundsFeeGrossAmountDecimalFalseNoDecimal money amount.
SummaryRefundsFeeGrossCurrencyCodeStringFalseNoCurrency of the money.
SummaryReservedFundsFeeAmountDecimalFalseNoDecimal money amount.
SummaryReservedFundsFeeCurrencyCodeStringFalseNoCurrency of the money.
SummaryReservedFundsGrossAmountDecimalFalseNoDecimal money amount.
SummaryReservedFundsGrossCurrencyCodeStringFalseNoCurrency of the money.
SummaryRetriedPayoutsFeeAmountDecimalFalseNoDecimal money amount.
SummaryRetriedPayoutsFeeCurrencyCodeStringFalseNoCurrency of the money.
SummaryRetriedPayoutsGrossAmountDecimalFalseNoDecimal money amount.
SummaryRetriedPayoutsGrossCurrencyCodeStringFalseNoCurrency of the money.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
ShopifyPaymentsAccountIdStringFalseShopifyPaymentsAccount.IdNoA globally-unique ID.
Type [KEY]StringFalseNoThe type of the document which can be used for verification.
BackRequiredBoolFalseNoTrue if the back side of the document is required.
FrontRequiredBoolFalseNoTrue if the front side of the document is required.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
ShopifyPaymentsAccountIdStringFalseShopifyPaymentsAccount.IdNoA globally-unique ID.
StatusStringFalseNoThe status of the verification.
SubjectFamilyNameStringFalseNoThe family name of the individual to verify.
SubjectGivenNameStringFalseNoThe given name of the individual to verify.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
ShopIdStringFalseShop.IdNoA globally-unique ID.
NameStringFalseNoThe staff member's full name.
FirstNameStringFalseNoThe staff member's first name.
LastNameStringFalseNoThe staff member's last name.
ActiveBoolFalseNoWhether the staff member is active.
EmailStringFalseNoThe staff member's email address.
ExistsBoolFalseNoWhether the staff member's account exists.
InitialsStringFalseNoThe staff member's initials, if available.
LocaleStringFalseNoThe staff member's preferred locale. Locale values use the format 'language' or 'language-COUNTRY', where 'language' is a two-letter language code, and 'COUNTRY' is a two-letter country code. For example: 'en' or 'en-US'
PhoneStringFalseNoThe staff member's phone number.
IsShopOwnerBoolFalseNoWhether the staff member is the shop owner.
PrivateDataAccountSettingsUrlStringFalseNoThe URL to the staff member's account settings page.
PrivateDataCreatedAtDatetimeFalseNoThe date and time when the staff member was created.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoA globally-unique ID.
ShopIdStringTrueShop.IdNoA globally-unique ID.
TitleStringTrueNoAn arbitrary title for each token determined by the developer, used for reference purposes.
AccessTokenStringTrueNoThe issued public access token.
CreatedAtDatetimeTrueNoThe date and time when the public access token was created.
UpdatedAtDatetimeTrueNoThe date and time when the storefront access token was updated.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoA globally-unique ID.
TestBoolFalseNoWhether the transaction is a test transaction.
PaymentMethodStringFalseNoInformation about the payment method used for the transaction.
ProcessedAtDatetimeFalseNoDate and time when the transaction was processed.
RemoteReferenceStringFalseNoThe remote gateway reference associated with the tender transaction.
AmountAmountDecimalFalseNoDecimal money amount.
AmountCurrencyCodeStringFalseNoCurrency of the money.
TenderTransactionCreditCardDetailsCreditCardCompanyStringFalseNoThe name of the company that issued the customer's credit card. Example: 'Visa'.
TenderTransactionCreditCardDetailsCreditCardNumberStringFalseNoThe customer's credit card number, with all digits except the last 4 redacted. Example: '???? ???? ???? 1234'
UserIdStringFalseNoA globally-unique ID.(This column is available only with a ShopifyPlus subscription)

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoThe ID of the URL redirect.
PathStringFalseNoThe old path to be redirected from. When the user visits this path, they will be redirected to the target location.
TargetStringFalseNoThe target location where the user will be redirected to.

Return to Top