Shopify List

Shopify List

Certified

List Shopify orders

Retrieves orders through the Shopify Admin API with optional filters (status, financial, fulfillment, date ranges). Supports fetch modes: FETCH (default), FETCH_ONE (first only), STORE (stream to storage URI). Limit honors Shopify cap.

yaml
type: io.kestra.plugin.shopify.orders.List

List all orders

yaml
id: shopify_list_orders
namespace: company.team

tasks:
  - id: list_orders
    type: io.kestra.plugin.shopify.orders.List
    storeDomain: my-store.myshopify.com
    accessToken: "{{ secret('SHOPIFY_ACCESS_TOKEN') }}"

List orders with filtering

yaml
id: shopify_list_orders_filtered
namespace: company.team

tasks:
  - id: list_orders
    type: io.kestra.plugin.shopify.orders.List
    storeDomain: my-store.myshopify.com
    accessToken: "{{ secret('SHOPIFY_ACCESS_TOKEN') }}"
    limit: 50
    status: "any"
    financialStatus: "paid"

Stream orders to storage

yaml
id: shopify_list_orders_store
namespace: company.team

tasks:
  - id: list_orders
    type: io.kestra.plugin.shopify.orders.List
    storeDomain: my-store.myshopify.com
    accessToken: "{{ secret('SHOPIFY_ACCESS_TOKEN') }}"
    fetchType: STORE
    limit: 200
Properties

Admin API access token

Private app Admin API access token sent as X-Shopify-Access-Token

Shopify store domain

Store domain used for Admin API calls (e.g., my-store.myshopify.com)

Default2024-10

API version

Shopify Admin API version path segment; defaults to 2024-10

Created at max

Return orders created at or before this ISO-8601 timestamp

Created at min

Return orders created at or after this ISO-8601 timestamp

DefaultFETCH
Possible Values
STOREFETCHFETCH_ONENONE

Fetch type

Controls result handling: FETCH (default), FETCH_ONE, or STORE

Financial status filter

Financial status filter (e.g., paid, pending, refunded)

Fulfillment status filter

Fulfillment status filter (e.g., shipped, partial, unshipped)

Limit

Maximum number of orders to retrieve (1-250)

Reference (ref) of the pluginDefaults to apply to this task.

DefaultPT0.5S

Rate limit delay

Sleep between API calls to respect Shopify rate limits; default 500ms

Since ID

Retrieve orders created after this Shopify order ID

Status filter

Order status filter: open, closed, cancelled, or any

Updated at max

Return orders updated at or before this ISO-8601 timestamp

Updated at min

Return orders updated at or after this ISO-8601 timestamp

Count

Number of orders returned or written

Orders

Orders retrieved when fetchType is FETCH or FETCH_ONE

Definitions
admin_graphql_api_idstring
app_idinteger
billing_address
address1string
address2string
citystring
companystring
countrystring
country_codestring
first_namestring
last_namestring
latitudenumber
longitudenumber
namestring
phonestring
provincestring
province_codestring
zipstring
browser_ipstring
buyer_accepts_marketingboolean
cancel_reasonstring
cancelled_atstring
Formatdate-time
cart_tokenstring
checkout_idinteger
checkout_tokenstring
closed_atstring
Formatdate-time
confirmedboolean
contact_emailstring
created_atstring
Formatdate-time
currencystring
current_subtotal_pricestring
current_subtotal_price_set
presentment_money
amountstring
currency_codestring
shop_money
amountstring
currency_codestring
current_total_discountsstring
current_total_discounts_set
presentment_money
amountstring
currency_codestring
shop_money
amountstring
currency_codestring
current_total_duties_set
presentment_money
amountstring
currency_codestring
shop_money
amountstring
currency_codestring
current_total_pricestring
current_total_price_set
presentment_money
amountstring
currency_codestring
shop_money
amountstring
currency_codestring
current_total_taxstring
current_total_tax_set
presentment_money
amountstring
currency_codestring
shop_money
amountstring
currency_codestring
customer
accepts_marketingboolean
accepts_marketing_updated_atstring
Formatdate-time
addressesarray
address1string
address2string
citystring
companystring
countrystring
country_codestring
country_namestring
customer_idinteger
defaultboolean
first_namestring
idinteger
last_namestring
namestring
phonestring
provincestring
province_codestring
zipstring
admin_graphql_api_idstring
created_atstring
Formatdate-time
currencystring
default_address
address1string
address2string
citystring
companystring
countrystring
country_codestring
country_namestring
customer_idinteger
defaultboolean
first_namestring
idinteger
last_namestring
namestring
phonestring
provincestring
province_codestring
zipstring
emailstring
first_namestring
idinteger
last_namestring
last_order_idinteger
last_order_namestring
marketing_opt_in_levelstring
metafieldsobject
multipass_identifierstring
notestring
orders_countinteger
phonestring
statestring
tagsstring
tax_exemptboolean
tax_exemptionsarray
SubTypestring
total_spentstring
updated_atstring
Formatdate-time
verified_emailboolean
customer_localestring
device_idstring
discount_applicationsarray
allocation_methodstring
descriptionstring
target_selectionstring
target_typestring
titlestring
typestring
valuestring
value_typestring
discount_codesarray
amountstring
codestring
typestring
emailstring
estimated_taxesboolean
financial_statusstring
fulfillment_statusstring
fulfillmentsarray
created_atstring
Formatdate-time
idinteger
line_itemsarray
admin_graphql_api_idstring
discount_allocationsarray
dutiesarray
SubTypeobject
fulfillable_quantityinteger
fulfillment_servicestring
fulfillment_statusstring
gift_cardboolean
gramsinteger
idinteger
namestring
pricestring
price_set
product_existsboolean
product_idinteger
propertiesobject
quantityinteger
requires_shippingboolean
skustring
tax_linesarray
taxableboolean
titlestring
total_discountstring
total_discount_set
variant_idinteger
variant_inventory_managementstring
variant_titlestring
vendorstring
order_idinteger
receipt
authorizationstring
testcaseboolean
servicestring
statusstring
tracking_companystring
tracking_numberstring
tracking_numbersarray
SubTypestring
tracking_urlstring
tracking_urlsarray
SubTypestring
updated_atstring
Formatdate-time
gatewaystring
idinteger
landing_sitestring
landing_site_refstring
line_itemsarray
admin_graphql_api_idstring
discount_allocationsarray
amountstring
amount_set
discount_application_indexinteger
dutiesarray
SubTypeobject
fulfillable_quantityinteger
fulfillment_servicestring
fulfillment_statusstring
gift_cardboolean
gramsinteger
idinteger
namestring
pricestring
price_set
presentment_money
shop_money
product_existsboolean
product_idinteger
propertiesobject
quantityinteger
requires_shippingboolean
skustring
tax_linesarray
channel_liableboolean
pricestring
price_set
ratenumber
titlestring
taxableboolean
titlestring
total_discountstring
total_discount_set
presentment_money
shop_money
variant_idinteger
variant_inventory_managementstring
variant_titlestring
vendorstring
location_idinteger
namestring
notestring
note_attributesarray
namestring
valuestring
numberinteger
order_numberinteger
order_status_urlstring
original_total_duties_set
presentment_money
amountstring
currency_codestring
shop_money
amountstring
currency_codestring
payment_gateway_namesarray
SubTypestring
payment_terms
amountinteger
currencystring
due_in_daysinteger
payment_schedulesarray
amountinteger
completed_atstring
Formatdate-time
currencystring
due_atstring
Formatdate-time
expected_payment_methodstring
issued_atstring
Formatdate-time
payment_terms_namestring
payment_terms_typestring
phonestring
presentment_currencystring
processed_atstring
Formatdate-time
processing_methodstring
referencestring
referring_sitestring
refundsarray
admin_graphql_api_idstring
created_atstring
Formatdate-time
dutiesarray
SubTypeobject
idinteger
notestring
order_adjustmentsarray
amountstring
amount_set
idinteger
kindstring
order_idinteger
reasonstring
refund_idinteger
tax_amountstring
tax_amount_set
order_idinteger
processed_atstring
Formatdate-time
refund_line_itemsarray
idinteger
line_item
line_item_idinteger
location_idinteger
quantityinteger
restock_typestring
subtotalstring
subtotal_set
total_taxstring
total_tax_set
restockboolean
total_duties_set
presentment_money
shop_money
transactionsarray
admin_graphql_api_idstring
amountstring
authorizationstring
created_atstring
Formatdate-time
currencystring
currency_exchange_adjustment
device_idstring
error_codestring
gatewaystring
idinteger
kindstring
location_idinteger
messagestring
order_idinteger
parent_idinteger
processed_atstring
Formatdate-time
receipt
source_namestring
statusstring
testboolean
user_idinteger
user_idinteger
shipping_address
address1string
address2string
citystring
companystring
countrystring
country_codestring
first_namestring
last_namestring
latitudenumber
longitudenumber
namestring
phonestring
provincestring
province_codestring
zipstring
shipping_linesarray
carrier_identifierstring
codestring
delivery_categorystring
discount_allocationsarray
amountstring
amount_set
discount_application_indexinteger
discounted_pricestring
discounted_price_set
presentment_money
shop_money
idinteger
phonestring
pricestring
price_set
presentment_money
shop_money
requested_fulfillment_service_idstring
sourcestring
tax_linesarray
channel_liableboolean
pricestring
price_set
ratenumber
titlestring
titlestring
source_identifierstring
source_namestring
source_urlstring
subtotal_pricestring
subtotal_price_set
presentment_money
amountstring
currency_codestring
shop_money
amountstring
currency_codestring
tagsstring
tax_linesarray
channel_liableboolean
pricestring
price_set
presentment_money
shop_money
ratenumber
titlestring
taxes_includedboolean
testboolean
tokenstring
total_discountsstring
total_discounts_set
presentment_money
amountstring
currency_codestring
shop_money
amountstring
currency_codestring
total_line_items_pricestring
total_line_items_price_set
presentment_money
amountstring
currency_codestring
shop_money
amountstring
currency_codestring
total_outstandingstring
total_pricestring
total_price_set
presentment_money
amountstring
currency_codestring
shop_money
amountstring
currency_codestring
total_price_usdstring
total_shipping_price_set
presentment_money
amountstring
currency_codestring
shop_money
amountstring
currency_codestring
total_taxstring
total_tax_set
presentment_money
amountstring
currency_codestring
shop_money
amountstring
currency_codestring
total_tip_receivedstring
total_weightinteger
updated_atstring
Formatdate-time
user_idinteger
Formaturi

URI

Storage URI written when fetchType is STORE