Shopify (version v2.*.*)

delete_blogs_id

Remove a Blog from the database

Parameters

id (required)

Type: string

delete_blogs_id_articles_id

Remove a Article from the database

Parameters

article_id (required)

Type: string

blog_id (required)

Type: string

delete_carrier_services_id

Remove a CarrierService from the database

Parameters

id (required)

Type: string

delete_collects_id

Remove a Collect from the database

Parameters

id (required)

Type: string

delete_countries_id

Remove a Country from the database

Parameters

id (required)

Type: string

delete_custom_collections_id

Remove a CustomCollection from the database

Parameters

id (required)

Type: string

delete_customer_saved_searches_id

Remove a CustomerSavedSearch from the database

Parameters

id (required)

Type: string

delete_customers_id

Remove a Customer from the database

Parameters

id (required)

Type: string

delete_customers_id_addresses_id

Remove a CustomerAddress from the database

Parameters

address_id (required)

Type: string

customer_id (required)

Type: string

delete_discounts_id

Remove a Discount from the database

Parameters

id (required)

Type: string

delete_order_fulfillment_events_id

Remove a FulfillmentEvent from the database

Parameters

event_id (required)

Type: string

fulfillment_id (required)

Type: string

order_id (required)

Type: string

delete_order_risks_id

Remove a Order Risks from the database

Parameters

order_id (required)

Type: string

risk_id (required)

Type: string

delete_orders_id

Remove a Order from the database

Parameters

id (required)

Type: string

delete_pages_id

Remove a Page from the database

Parameters

id (required)

Type: string

delete_product_variant_by_id

Remove a Product Variant from the database

Parameters

product_id (required)

Type: string

variant_id (required)

Type: string

delete_products_id

Remove a Product from the database

Parameters

id (required)

Type: string

delete_products_id_images_id

Remove a Product Image from the database

Parameters

image_id (required)

Type: string

product_id (required)

Type: string

delete_products_metafields_by_id

Delete a product metafield

Parameters

field_id (required)

Type: string

product_id (required)

Type: string

delete_recurring_application_charges_id

Cancel a recurring application charge

Parameters

id (required)

Type: string

delete_redirects_id

Remove a Redirect from the database

Parameters

id (required)

Type: string

delete_script_tags_id

Remove a ScriptTag from the database

Parameters

id (required)

Type: string

delete_themes_id_assets

Remove a Asset from the database

Parameters

id (required)

Type: string

delete_webhooks_id

Remove a Webhook from the database

Parameters

id (required)

Type: string

get_application_charges

Retrieve all one-time application charges

Parameters

fields

comma-separated list of fields to include in the response

Type: string

since_id

Restrict results to after the specified ID

Type: string

get_application_charges_id

Receive a single ApplicationCharge

Parameters

id (required)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

get_application_credits

Retrieve all application credits

Parameters

fields

comma-separated list of fields to include in the response

Type: string

get_application_credits_id

Receive a single ApplicationCredit

Parameters

id (required)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

get_articles_authors

This operation has no parameters

get_articles_tags

Get a list of all the tags

Parameters

limit

The number of tags to return

Type: string

A flag to indicate only to a certain number of the most popular tags

Type: string

get_blogs

Receive a list of all Blogs

Parameters

fields

comma-separated list of fields to include in the response

Type: string

handle

Filter by blog handle

Type: string

since_id

Restrict results to after the specified ID

Type: string

get_blogs_count

This operation has no parameters

get_blogs_id

Receive a single Blog

Parameters

id (required)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

get_blogs_id_articles

Receive a list of all Articles

Parameters

id (required)

Type: string

created_at_max

Show articles created before date (format: 2014-04-25T16:15:47-04:00)

Type: string

created_at_min

Show articles created after date (format: 2014-04-25T16:15:47-04:00)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

handle

Filter by article handle

Type: string

limit

Amount of results (default: 50) (maximum: 250)

Type: string

page

Page to show (default: 1)

Type: string

published_at_max

Show articles published before date (format: 2014-04-25T16:15:47-04:00)

Type: string

published_at_min

Show articles published after date (format: 2014-04-25T16:15:47-04:00)

Type: string

published_status

published - Show only published articles unpublished - Show only unpublished articles any - Show all articles (default)

Type: string

since_id

Restrict results to after the specified ID

Type: string

updated_at_max

Show articles last updated before date (format: 2014-04-25T16:15:47-04:00)

Type: string

updated_at_min

Show articles last updated after date (format: 2014-04-25T16:15:47-04:00)

Type: string

get_blogs_id_articles_count

Receive a count of all Articles

Parameters

id (required)

Type: string

created_at_max

Count articles created before date (format: 2014-04-25T16:15:47-04:00)

Type: string

created_at_min

Count articles created after date (format: 2014-04-25T16:15:47-04:00)

Type: string

published_at_max

Count articles published before date (format: 2014-04-25T16:15:47-04:00)

Type: string

published_at_min

Count articles published after date (format: 2014-04-25T16:15:47-04:00)

Type: string

published_status

published - Count only published articles unpublished - Count only unpublished articles any - Count all articles (default)

Type: string

updated_at_max

Count articles last updated before date (format: 2014-04-25T16:15:47-04:00)

Type: string

updated_at_min

Count articles last updated after date (format: 2014-04-25T16:15:47-04:00)

Type: string

get_blogs_id_articles_id

Receive a single Article

Parameters

article_id (required)

Type: string

blog_id (required)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

get_carrier_services

This operation has no parameters

get_carrier_services_id

Receive a single CarrierService

Parameters

id (required)

Type: string

get_checkouts

Receive a list of all Abandoned checkouts

Parameters

created_at_max

Show checkouts created before date (format: 2014-04-25T16:15:47-04:00)

Type: string

created_at_min

Show checkouts created after date (format: 2014-04-25T16:15:47-04:00)

Type: string

limit

Amount of results (default: 50) (maximum: 250)

Type: string

page

Page to show (default: 1)

Type: string

since_id

Restrict results to after the specified ID

Type: string

status

open - All open abandoned checkouts (default) closed - Show only closed abandoned checkouts

Type: string

updated_at_max

Show checkouts last updated before date (format: 2014-04-25T16:15:47-04:00)

Type: string

updated_at_min

Show checkouts last updated after date (format: 2014-04-25T16:15:47-04:00)

Type: string

get_checkouts_count

Receive a count of all Abandoned checkouts

Parameters

created_at_max

Show checkouts created before date (format: 2014-04-25T16:15:47-04:00)

Type: string

created_at_min

Show checkouts created after date (format: 2014-04-25T16:15:47-04:00)

Type: string

since_id

Restrict results to after the specified ID

Type: string

status

open - All open abandoned checkouts (default) closed - Show only closed abandoned checkouts

Type: string

updated_at_max

Show checkouts last updated before date (format: 2014-04-25T16:15:47-04:00)

Type: string

updated_at_min

Show checkouts last updated after date (format: 2014-04-25T16:15:47-04:00)

Type: string

get_collects

Receive a list of all Collects

Parameters

fields

comma-separated list of fields to include in the response

Type: string

limit

Collects per page (default: 50) (maximum: 250)

Type: string

page

Page to show (default: 1)

Type: string

get_collects_count

This operation has no parameters

get_collects_id

Receive a single Collect

Parameters

id (required)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

get_comments

Receive a list of all Comments

Parameters

created_at_max

Show comments created before date (format: 2014-04-25T16:15:47-04:00)

Type: string

created_at_min

Show comments created after date (format: 2014-04-25T16:15:47-04:00)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

limit

Amount of results (default: 50) (maximum: 250)

Type: string

page

Page to show (default: 1)

Type: string

published_at_max

Show comments published before date (format: 2014-04-25T16:15:47-04:00)

Type: string

published_at_min

Show comments published after date (format: 2014-04-25T16:15:47-04:00)

Type: string

published_status

published - Show only published comments unpublished - Show only unpublished comments any - Show all comments (default)

Type: string

since_id

Restrict results to after the specified ID

Type: string

status

pending - All pending comments published - Show only published comments unapproved - Show only unapproved comments

Type: string

updated_at_max

Show comments last updated before date (format: 2014-04-25T16:15:47-04:00)

Type: string

updated_at_min

Show comments last updated after date (format: 2014-04-25T16:15:47-04:00)

Type: string

get_comments_count

Receive a count of all Comments

Parameters

created_at_max

Count comments created before date (format: 2014-04-25T16:15:47-04:00)

Type: string

created_at_min

Count comments created after date (format: 2014-04-25T16:15:47-04:00)

Type: string

published_at_max

Count comments published before date (format: 2014-04-25T16:15:47-04:00)

Type: string

published_at_min

Count comments published after date (format: 2014-04-25T16:15:47-04:00)

Type: string

published_status

published - Count only published comments unpublished - Count only unpublished comments any - Count all comments (default)

Type: string

status

pending - All pending comments published - Count only published comments unapproved - Count only unapproved comments

Type: string

updated_at_max

Count comments last updated before date (format: 2014-04-25T16:15:47-04:00)

Type: string

updated_at_min

Count comments last updated after date (format: 2014-04-25T16:15:47-04:00)

Type: string

get_comments_id

Receive a single Comment

Parameters

id (required)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

get_countries

Receive a list of all Countries

Parameters

fields

comma-separated list of fields to include in the response

Type: string

since_id

Restrict results to after the specified ID

Type: string

get_countries_count

This operation has no parameters

get_countries_id

Receive a single Country

Parameters

id (required)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

get_countries_id_provinces

Receive a list of all Provinces

Parameters

id (required)

Type: string

country_id

The id of the country the province belongs to

Type: string

fields

comma-separated list of fields to include in the response

Type: string

since_id

Restrict results to after the specified ID

Type: string

get_countries_id_provinces_count

Receive a count of all Provinces

Parameters

id (required)

Type: string

get_countries_provinces_by_id

Receive a single Province

Parameters

country_id (required)

Type: string

province_id (required)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

get_custom_collections

Receive a list of all CustomCollections

Parameters

fields

comma-separated list of fields to include in the response

Type: string

handle

Filter by custom collection handle

Type: string

ids

A comma-separated list of collection ids

Type: string

limit

Amount of results (default: 50) (maximum: 250)

Type: string

page

Page to show (default: 1)

Type: string

product_id

Show custom collections that includes given product

Type: string

published_at_max

Show custom collections published before date (format: 2014-04-25T16:15:47-04:00)

Type: string

published_at_min

Show custom collections published after date (format: 2014-04-25T16:15:47-04:00)

Type: string

published_status

published - Show only published custom collections unpublished - Show only unpublished custom collections any - Show all custom collections (default)

Type: string

since_id

Restrict results to after the specified ID

Type: string

title

Show custom collections with given title

Type: string

updated_at_max

Show custom collections last updated before date (format: 2014-04-25T16:15:47-04:00)

Type: string

updated_at_min

Show custom collections last updated after date (format: 2014-04-25T16:15:47-04:00)

Type: string

get_custom_collections_count

Receive a count of all CustomCollections

Parameters

product_id

Count custom collections that includes given product

Type: string

published_at_max

Show custom collections published before date (format: 2014-04-25T16:15:47-04:00)

Type: string

published_at_min

Show custom collections published after date (format: 2014-04-25T16:15:47-04:00)

Type: string

published_status

published - Show only published custom collections unpublished - Show only unpublished custom collections any - Show all custom collections (default)

Type: string

title

Count custom collections with given title

Type: string

updated_at_max

Count custom collections last updated before date (format: 2014-04-25T16:15:47-04:00)

Type: string

updated_at_min

Count custom collections last updated after date (format: 2014-04-25T16:15:47-04:00)

Type: string

get_custom_collections_id

Receive a single CustomCollection

Parameters

id (required)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

get_customer_saved_searches

Receive a list of all CustomerSavedSearches

Parameters

fields

comma-separated list of fields to include in the response

Type: string

limit

Amount of results (default: 50) (maximum: 250)

Type: string

page

Page to show (default: 1)

Type: string

since_id

Restrict results to after the specified ID

Type: string

get_customer_saved_searches_count

Receive a count of all CustomerSavedSearches

Parameters

since_id

Restrict results to after the specified ID

Type: string

get_customer_saved_searches_id

Receive a single CustomerSavedSearch

Parameters

id (required)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

get_customers

Receive a list of all Customers

Parameters

created_at_max

Show customers created before date (format: 2014-04-25T16:15:47-04:00)

Type: string

created_at_min

Show customers created after date (format: 2014-04-25T16:15:47-04:00)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

ids

A comma-separated list of customer ids

Type: string

limit

Amount of results (default: 50) (maximum: 250)

Type: string

page

Page to show (default: 1)

Type: string

since_id

Restrict results to after the specified ID

Type: string

updated_at_max

Show customers last updated before date (format: 2014-04-25T16:15:47-04:00)

Type: string

updated_at_min

Show customers last updated after date (format: 2014-04-25T16:15:47-04:00)

Type: string

get_customers_count

This operation has no parameters

get_customers_id

Receive a single Customer

Parameters

id (required)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

get_customers_id_addresses

Receive a list of all CustomerAddresses

Parameters

id (required)

Type: string

get_customers_id_addresses_id

Receive a single CustomerAddress

Parameters

address_id (required)

Type: string

customer_id (required)

Type: string

Search for customers matching supplied query

Parameters

fields

comma-separated list of fields to include in the response

Type: string

limit

Amount of results (default: 50) (maximum: 250)

Type: string

order

Field and direction to order results by (default: last_order_date DESC)

Type: string

page

Page to show (default: 1)

Type: string

query

Text to search customers

Type: string

get_discounts

Receive a list of all Discounts

Parameters

limit

Number of results per page (default: 15) (maximum: 200)

Type: string

page

Page to show (default: 1)

Type: string

get_discounts_id

Receive a single Discount

Parameters

id (required)

Type: string

get_events

Receive a list of all Events

Parameters

created_at_max

Show events created at or before date and time (format: 2014-04-25T16:15:47-04:00)

Type: string

created_at_min

Show events created at or after date and time (format: 2014-04-25T16:15:47-04:00)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

filter

Only show events specified in filter

Type: string

limit

Amount of results (default: 50) (maximum: 250)

Type: string

page

Page to show (default: 1)

Type: string

since_id

Restrict results to after the specified ID

Type: string

verb

Only show events of a certain kind

Type: string

get_events_count

Receive a count of all Events

Parameters

created_at_max

Count events created at or before date and time (format: 2014-04-25T16:15:47-04:00)

Type: string

created_at_min

Count events created at or after date and time (format: 2014-04-25T16:15:47-04:00)

Type: string

get_events_id

Receive a single Event

Parameters

id (required)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

get_gift_cards

Receive a list of all Gift Cards

Parameters

fields

comma-separated list of fields to include in the response

Type: string

limit

Amount of results (default: 50) (maximum: 250)

Type: string

page

Page to show (default: 1)

Type: string

status

enabled - Restrict results to only enabled gift cards disabled - Restrict results to only disabled gift cards

Type: string

get_gift_cards_count

Receive a count of all Gift Cards

Parameters

status

enabled - Count only enabled gift cards disabled - Count only disabled gift cards

Type: string

get_gift_cards_id

Receive a single Gift Card

Parameters

id (required)

Type: string

Search for gift cards matching supplied query

Parameters

fields

comma-separated list of fields to include in the response

Type: string

limit

Amount of results (default: 50) (maximum: 250)

Type: string

order

Field and direction to order results by (default: disabled_at DESC)

Type: string

page

Page to show (default: 1)

Type: string

query

Text to search gift cards

Type: string

get_locations

This operation has no parameters

get_locations_id

Receive a single Location

Parameters

id (required)

Type: string

get_metafields

This operation has no parameters

get_order_fulfillment_events

Receive a list of all FulfillmentEvents

Parameters

fulfillment_id (required)

Type: string

order_id (required)

Type: string

get_order_fulfillment_events_id

Receive a single FulfillmentEvent

Parameters

event_id (required)

Type: string

fulfillment_id (required)

Type: string

order_id (required)

Type: string

get_order_fulfillments

Receive a list of all Fulfillments

Parameters

id (required)

Type: string

created_at_max

Show fulfillments created before date (format: 2014-04-25T16:15:47-04:00)

Type: string

created_at_min

Show fulfillments created after date (format: 2014-04-25T16:15:47-04:00)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

limit

Amount of results (default: 50) (maximum: 250)

Type: string

page

Page to show (default: 1)

Type: string

since_id

Restrict results to after the specified ID

Type: string

updated_at_max

Show fulfillments last updated before date (format: 2014-04-25T16:15:47-04:00)

Type: string

updated_at_min

Show fulfillments last updated after date (format: 2014-04-25T16:15:47-04:00)

Type: string

get_order_fulfillments_by_id

Receive a single Fulfillment

Parameters

fulfillment_id (required)

Type: string

order_id (required)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

get_order_fulfillments_count

Receive a count of all Fulfillments

Parameters

id (required)

Type: string

created_at_max

Count fulfillments created before date (format: 2014-04-25T16:15:47-04:00)

Type: string

created_at_min

Count fulfillments created after date (format: 2014-04-25T16:15:47-04:00)

Type: string

updated_at_max

Count fulfillments last updated before date (format: 2014-04-25T16:15:47-04:00)

Type: string

updated_at_min

Count fulfillments last updated after date (format: 2014-04-25T16:15:47-04:00)

Type: string

get_order_refunds

Retrieve a list of Refunds for an Order

Parameters

id (required)

Type: string

fields

Comma-separated list of fields to include in the response

Type: string

get_order_refunds_id

Receive a single Refund

Parameters

order_id (required)

Type: string

refund_id (required)

Type: string

fields

Comma-separated list of fields to include in the response

Type: string

get_order_risks

Receive a list of all Order Risks

Parameters

id (required)

Type: string

get_order_risks_id

Receive a single Order Risks

Parameters

order_id (required)

Type: string

risk_id (required)

Type: string

get_order_transactions

Receive a list of all Transactions

Parameters

id (required)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

since_id

Restrict results to after the specified ID

Type: string

get_order_transactions_count

Receive a count of all Transactions

Parameters

id (required)

Type: string

get_order_transactions_id

Receive a single Transaction

Parameters

order_id (required)

Type: string

transaction_id (required)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

get_orders

Retrieve a list of Orders (OPEN Orders by default, use status=any for ALL orders)

Parameters

created_at_max

Show orders created before date (format: 2014-04-25T16:15:47-04:00)

Type: string

created_at_min

Show orders created after date (format: 2014-04-25T16:15:47-04:00)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

financial_status

authorized - Show only authorized orders pending - Show only pending orders paid - Show only paid orders partially_paid - Show only partially paid orders refunded - Show only refunded orders voided - Show only voided orders partially_refunded - Show only partially_refunded orders any - Show all authorized, pending, and paid orders (default). This is a filter, not a value. unpaid - Show all authorized, or partially_paid orders. This is a filter, not a value.

Type: string

fulfillment_status

shipped - Show orders that have been shipped partial - Show partially shipped orders unshipped - Show orders that have not yet been shipped any - Show orders with any fulfillment_status. (default)

Type: string

ids

A comma-separated list of order ids

Type: string

limit

Amount of results (default: 50) (maximum: 250)

Type: string

page

Page to show (default: 1)

Type: string

processed_at_max

Show orders imported before date (format: 2014-04-25T16:15:47-04:00)

Type: string

processed_at_min

Show orders imported after date (format: 2014-04-25T16:15:47-04:00)

Type: string

since_id

Restrict results to after the specified ID

Type: string

status

open - All open orders (default) closed - Show only closed orders cancelled - Show only cancelled orders any - Any order status

Type: string

updated_at_max

Show orders last updated before date (format: 2014-04-25T16:15:47-04:00)

Type: string

updated_at_min

Show orders last updated after date (format: 2014-04-25T16:15:47-04:00)

Type: string

get_orders_count

Receive a count of all Orders

Parameters

created_at_max

Count orders created before date (format: 2014-04-25T16:15:47-04:00)

Type: string

created_at_min

Count orders created after date (format: 2014-04-25T16:15:47-04:00)

Type: string

financial_status

authorized - Only authorized orders pending - Only pending orders paid - Only paid orders refunded - Show only refunded orders voided - Show only voided orders any - All authorized, pending, and paid orders (default)

Type: string

fulfillment_status

shipped - Orders that have been shipped partial - Partially shipped orders unshipped - Orders that have not yet been shipped any - Orders with any fulfillment_status. (default)

Type: string

status

open - Open orders (default) closed - Only closed orders any - Any order status

Type: string

updated_at_max

Count orders last updated before date (format: 2014-04-25T16:15:47-04:00)

Type: string

updated_at_min

Count orders last updated after date (format: 2014-04-25T16:15:47-04:00)

Type: string

get_orders_id

Receive a single Order

Parameters

id (required)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

get_pages

Receive a list of all Pages

Parameters

created_at_max

Show pages created before date (format: 2008-12-31)

Type: string

created_at_min

Show pages created after date (format: 2008-12-31)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

handle

Filter by Page handle

Type: string

limit

Amount of results (default: 50) (maximum: 250)

Type: string

page

Page to show (default: 1)

Type: string

published_at_max

Show pages published before date (format: 2014-04-25T16:15:47-04:00)

Type: string

published_at_min

Show pages published after date (format: 2014-04-25T16:15:47-04:00)

Type: string

published_status

published - Show only published pages unpublished - Show only unpublished pages any - Show all pages (default)

Type: string

since_id

Restrict results to after the specified ID

Type: string

title

Show pages by Title

Type: string

updated_at_max

Show pages last updated before date (format: 2008-12-31)

Type: string

updated_at_min

Show pages last updated after date (format: 2008-12-31)

Type: string

get_pages_count

Receive a count of all Pages

Parameters

created_at_max

Pages created before date (format: 2008-12-31)

Type: string

created_at_min

Pages created after date (format: 2008-12-31)

Type: string

published_at_max

Show pages published before date (format: 2014-04-25T16:15:47-04:00)

Type: string

published_at_min

Show pages published after date (format: 2014-04-25T16:15:47-04:00)

Type: string

published_status

published - Only published pages unpublished - Only unpublished pages any - All pages (default)

Type: string

title

Pages with a given title

Type: string

updated_at_max

Pages last updated before date (format: 2008-12-31)

Type: string

updated_at_min

Pages last updated after date (format: 2008-12-31)

Type: string

get_pages_id

Receive a single Page

Parameters

id (required)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

get_policies

This operation has no parameters

get_products

Receive a list of all Products

Parameters

collection_id

Filter by collection id

Type: string

created_at_max

Show products created before date (format: 2014-04-25T16:15:47-04:00)

Type: string

created_at_min

Show products created after date (format: 2014-04-25T16:15:47-04:00)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

handle

Filter by product handle

Type: string

ids

A comma-separated list of product ids

Type: string

limit

Amount of results (default: 50) (maximum: 250)

Type: string

page

Page to show (default: 1)

Type: string

product_type

Filter by product type

Type: string

published_at_max

Show products published before date (format: 2014-04-25T16:15:47-04:00)

Type: string

published_at_min

Show products published after date (format: 2014-04-25T16:15:47-04:00)

Type: string

published_status

published - Show only published products unpublished - Show only unpublished products any - Show all products (default)

Type: string

since_id

Restrict results to after the specified ID

Type: string

title

Filter by product title

Type: string

updated_at_max

Show products last updated before date (format: 2014-04-25T16:15:47-04:00)

Type: string

updated_at_min

Show products last updated after date (format: 2014-04-25T16:15:47-04:00)

Type: string

vendor

Filter by product vendor

Type: string

get_products_count

Receive a count of all Products

Parameters

collection_id

Filter by collection id

Type: string

created_at_max

Show products created before date (format: 2014-04-25T16:15:47-04:00)

Type: string

created_at_min

Show products created after date (format: 2014-04-25T16:15:47-04:00)

Type: string

product_type

Filter by product type

Type: string

published_at_max

Show products published before date (format: 2014-04-25T16:15:47-04:00)

Type: string

published_at_min

Show products published after date (format: 2014-04-25T16:15:47-04:00)

Type: string

published_status

published - Show only published products unpublished - Show only unpublished products any - Show all products (default)

Type: string

updated_at_max

Show products last updated before date (format: 2014-04-25T16:15:47-04:00)

Type: string

updated_at_min

Show products last updated after date (format: 2014-04-25T16:15:47-04:00)

Type: string

vendor

Filter by product vendor

Type: string

get_products_id

Receive a single Product

Parameters

id (required)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

get_products_id_images

Receive a list of all Product Images

Parameters

id (required)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

since_id

Restrict results to after the specified ID

Type: string

get_products_id_images_count

Receive a count of all Product Images

Parameters

id (required)

Type: string

created_at_max

Count articles created before date (format: 2014-04-25T16:15:47-04:00)

Type: string

created_at_min

Count articles created after date (format: 2014-04-25T16:15:47-04:00)

Type: string

published_at_max

Count articles published before date (format: 2014-04-25T16:15:47-04:00)

Type: string

published_at_min

Count articles published after date (format: 2014-04-25T16:15:47-04:00)

Type: string

since_id

Restrict results to after the specified ID

Type: string

updated_at_max

Count articles last updated before date (format: 2014-04-25T16:15:47-04:00)

Type: string

updated_at_min

Count articles last updated after date (format: 2014-04-25T16:15:47-04:00)

Type: string

get_products_id_images_id

Receive a single Product Image

Parameters

image_id (required)

Type: string

product_id (required)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

get_products_id_metafields_count

Get a count of metafields that belong to a product

Parameters

id (required)

Type: string

get_products_id_variants

Receive a list of all Product Variants

Parameters

id (required)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

limit

Amount of results (default: 50) (maximum: 250)

Type: string

page

Page to show (default: 1)

Type: string

since_id

Restrict results to after the specified ID

Type: string

get_products_id_variants_count

Receive a count of all Product Variants

Parameters

id (required)

Type: string

get_products_metafields_by_id

Get a single product metafield by its ID

Parameters

field_id (required)

Type: string

product_id (required)

Type: string

get_recurring_application_charges

Retrieve all recurring application charges

Parameters

fields

comma-separated list of fields to include in the response

Type: string

since_id

Restrict results to after the specified ID

Type: string

get_recurring_application_charges_id

Receive a single RecurringApplicationCharge

Parameters

id (required)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

get_recurring_application_charges_id_usage_charges

Retrieve all usage charges

Parameters

id (required)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

get_recurring_application_charges_id_usage_charges_id

Receive a single UsageCharge

Parameters

recurring_application_charge_id (required)

Type: string

usage_charge_id (required)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

get_redirects

Receive a list of all Redirects

Parameters

fields

comma-separated list of fields to include in the response

Type: string

limit

Amount of results (default: 50) (maximum: 250)

Type: string

page

Page to show (default: 1)

Type: string

path

Show Redirects with given path

Type: string

since_id

Restrict results to after the specified ID

Type: string

target

Show Redirects with given target

Type: string

get_redirects_count

Receive a count of all Redirects

Parameters

path

Count Redirects with given path

Type: string

target

Count Redirects with given target

Type: string

get_redirects_id

Receive a single Redirect

Parameters

id (required)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

get_script_tags

Receive a list of all ScriptTags

Parameters

created_at_max

Show script_tags created before date (format: 2014-04-25T16:15:47-04:00)

Type: string

created_at_min

Show script_tags created after date (format: 2014-04-25T16:15:47-04:00)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

limit

Amount of results (default: 50) (maximum: 250)

Type: string

page

Page to show (default: 1)

Type: string

since_id

Restrict results to after the specified ID

Type: string

src

Show script tags with a given URL

Type: string

updated_at_max

Show script_tags last updated before date (format: 2014-04-25T16:15:47-04:00)

Type: string

updated_at_min

Show script_tags last updated after date (format: 2014-04-25T16:15:47-04:00)

Type: string

get_script_tags_count

Receive a count of all ScriptTags

Parameters

src

Count script tags with given URL

Type: string

get_script_tags_id

Receive a single ScriptTag

Parameters

id (required)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

get_shipping_zones

Receive a list of all Shipping Zones

Parameters

fields

comma-separated list of fields to include in the response

Type: string

get_shop

Receive a single Shop

Parameters

fields

comma-separated list of fields to include in the response

Type: string

get_smart_collections

Receive a list of all SmartCollections

Parameters

fields

comma-separated list of fields to include in the response

Type: string

handle

Filter by smart collection handle

Type: string

ids

A comma-separated list of collection ids

Type: string

limit

Amount of results (default: 50) (maximum: 250)

Type: string

page

Page to show (default: 1)

Type: string

product_id

Show smart collections that includes given product

Type: string

published_at_max

Show smart collections published before date (format: 2014-04-25T16:15:47-04:00)

Type: string

published_at_min

Show smart collections published after date (format: 2014-04-25T16:15:47-04:00)

Type: string

published_status

published - Show only published smart collections unpublished - Show only unpublished smart collections any - Show all smart collections (default)

Type: string

since_id

Restrict results to after the specified ID

Type: string

title

Show smart collections with given title

Type: string

updated_at_max

Show smart collections last updated before date (format: 2014-04-25T16:15:47-04:00)

Type: string

updated_at_min

Show smart collections last updated after date (format: 2014-04-25T16:15:47-04:00)

Type: string

get_smart_collections_count

Receive a count of all SmartCollections

Parameters

product_id

Show smart collections that includes given product

Type: string

published_at_max

Show smart collections published before date (format: 2014-04-25T16:15:47-04:00)

Type: string

published_at_min

Show smart collections published after date (format: 2014-04-25T16:15:47-04:00)

Type: string

published_status

published - Show only published smart collections unpublished - Show only unpublished smart collections any - Show all smart collections (default)

Type: string

title

Show smart collections with given title

Type: string

updated_at_max

Show smart collections last updated before date (format: 2014-04-25T16:15:47-04:00)

Type: string

updated_at_min

Show smart collections last updated after date (format: 2014-04-25T16:15:47-04:00)

Type: string

get_themes

Receive a list of all Themes

Parameters

fields

comma-separated list of fields to include in the response

Type: string

get_themes_id_assets

Receive a single Asset

Parameters

id (required)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

get_users

This operation has no parameters

get_users_current

This operation has no parameters

get_users_id

Receive a single User

Parameters

id (required)

Type: string

get_variants_id

Receive a single Product Variant

Parameters

id (required)

Type: string

fields

comma-separated list of fields to include in the response

Type: string

get_webhooks

Receive a list of all Webhooks

Parameters

address

Use this parameter to retrieve only webhooks that possess the URI where the webhook sends the POST request when the event occurs.

Type: string

created_at_max

Use this parameter to retrieve only webhooks that were created before a given date and time (format: 2014-04-25T16:15:47-04:00).

Type: string

created_at_min

Use this parameter to retrieve only webhooks that were created after a given date and time (format: 2014-04-25T16:15:47-04:00).

Type: string

fields

A comma-separated list of the properties you want returned for each item in the result list. Use this parameter to restrict the returned list of items to showing only those properties you specify.

Type: string

limit

The maximum number of webhooks that should be returned. Setting this parameter outside the maximum range will result in an error. (default: 50) (maximum: 250)

Type: string

page

The page number of the result list to retrieve. Use this in tandem with limit to page through the webhooks in a shop. (default: 1)

Type: string

since_id

Use this parameter to restrict the returned list to only webhooks whose id is greater than the specified id.

Type: string

topic

Show webhooks with a given topic. Valid topics are: carts/create, carts/update, checkouts/create, checkouts/delete, checkouts/update, collections/create, collections/delete, collections/update, customer_groups/create, customer_groups/delete, customer_groups/update, customers/create, customers/delete, customers/disable, customers/enable, customers/update, disputes/create, disputes/update, fulfillment_events/create, fulfillment_events/delete, fulfillments/create, fulfillments/update, order_transactions/create, orders/cancelled, orders/create, orders/delete, orders/fulfilled, orders/paid, orders/partially_fulfilled, orders/updated, products/create, products/delete, products/update, refunds/create, shop/update, themes/create, themes/delete, themes/publish, themes/update

Type: string

updated_at_max

Use this parameter to retrieve only webhooks that were updated after a given date and time (format: 2014-04-25T16:15:47-04:00).

Type: string

updated_at_min

Use this parameter to retrieve only webhooks that were updated before a given date and time (format: 2014-04-25T16:15:47-04:00).

Type: string

get_webhooks_count

Receive a count of all Webhooks

Parameters

address

Use this parameter to retrieve only webhooks that possess the URI where the webhook sends the POST request when the event occurs.

Type: string

topic

Show webhooks with a given topic. Valid topics are: carts/create, carts/update, checkouts/create, checkouts/delete, checkouts/update, collections/create, collections/delete, collections/update, customer_groups/create, customer_groups/delete, customer_groups/update, customers/create, customers/delete, customers/disable, customers/enable, customers/update, disputes/create, disputes/update, fulfillment_events/create, fulfillment_events/delete, fulfillments/create, fulfillments/update, order_transactions/create, orders/cancelled, orders/create, orders/delete, orders/fulfilled, orders/paid, orders/partially_fulfilled, orders/updated, products/create, products/delete, products/update, refunds/create, shop/update, themes/create, themes/delete, themes/publish, themes/update

Type: string

get_webhooks_id

Receive a single Webhook

Parameters

id (required)

Type: string

fields

A comma-separated list of the properties you want returned for each item in the result list. Use this parameter to restrict the returned list of items to showing only those properties you specify.

Type: string

post_application_charges

This operation has no parameters

post_application_charges_id_activate

Activate a one-time application charge

Parameters

id (required)

Type: string

post_application_credits

This operation has no parameters

post_blogs

This operation has no parameters

post_blogs_id_articles

Create a new Article

Parameters

id (required)

Type: string

post_carrier_services

This operation has no parameters

post_collects

This operation has no parameters

post_comments

This operation has no parameters

post_countries

This operation has no parameters

post_custom_collections

This operation has no parameters

post_customer_saved_searches

This operation has no parameters

post_customers_id_addresses

Create a new CustomerAddress

Parameters

id (required)

Type: string

post_discounts

This operation has no parameters

post_discounts_id_disable

Disable a discount

Parameters

id (required)

Type: string

post_discounts_id_enable

Enable a discount

Parameters

id (required)

Type: string

post_gift_cards

This operation has no parameters

post_gift_cards_id_disable

Disabling a gift card is permanent and cannot be undone.

Parameters

id (required)

Type: string

post_order_close

Close an Order

Parameters

id (required)

Type: string

post_order_fulfillment_cancel

Cancel a fulfillment

Parameters

fulfillment_id (required)

Type: string

order_id (required)

Type: string

post_order_fulfillment_complete

Complete a fulfillment

Parameters

fulfillment_id (required)

Type: string

order_id (required)

Type: string

post_order_fulfillment_events

Create a new FulfillmentEvent

Parameters

fulfillment_id (required)

Type: string

order_id (required)

Type: string

post_order_fulfillment_open

Transition a fulfillment from pending to open.

Parameters

fulfillment_id (required)

Type: string

order_id (required)

Type: string

post_order_fulfillments

Create a new Fulfillment

Parameters

id (required)

Type: string

post_order_open

Re-open a closed Order

Parameters

id (required)

Type: string

post_order_refunds

Create a Refund

Parameters

id (required)

Type: string

discrepancy_reason

An optional comment, used if there is a discrepancy between calculated and actual refund amounts (one of: restock, damage, customer, other)

Type: string

note

An optional comment attached to a refund.

Type: string

notify

Boolean, set to true to send a refund notification to the customer.

Type: string

refund_line_items

Array of line item IDs and quantities to refund

Type: string

restock

Boolean, whether or not to add the line items back to the store inventory.

Type: string

shipping

Object to specify how much shipping to refund full_refund - Boolean, set to true to refund all remaining shipping amount - Set specific amount of shipping to refund. Takes precedence over full_refund .

Type: string

transactions

Array of transactions to process as refunds

Type: string

post_order_refunds_calculate

Calculate a Refund

Parameters

id (required)

Type: string

refund_line_items

Array of line item IDs and quantities to refund

Type: string

shipping

Object to specify how much shipping to refund full_refund - Boolean, set to true to refund all remaining shipping amount - Set specific amount of shipping to refund. Takes precedence over full_refund .

Type: string

post_order_risks

Create a new Order Risks

Parameters

id (required)

Type: string

post_order_transactions

Create a new Transaction

Parameters

id (required)

Type: string

post_orders

Create a new Order

Parameters

order

In addition to the properties defined earlier, you can use the following flags send_receipt - Determines whether an order confirmation will be sent to the customer. Default: false. send_fulfillment_receipt - Determines whether a fulfillment confirmation will be sent to the customer. Default: false. inventory_behaviour - Determines which inventory updating behaviour is used. The following values are available: bypass (default) : Do not claim inventory. decrement_ignoring_policy : Ignore the product's inventory policy and claim amounts no matter what. decrement_obeying_policy : Obey the product's inventory policy.

Type: string

post_pages

This operation has no parameters

post_products

This operation has no parameters

post_products_id_images

Create a new Product Image

Parameters

id (required)

Type: string

post_products_id_metafields

Create a new metafield for a product

Parameters

id (required)

Type: string

post_products_id_variants

Create a new Product Variant

Parameters

id (required)

Type: string

post_recurring_application_charges

This operation has no parameters

post_recurring_application_charges_id_activate

Activate a recurring application charge

Parameters

id (required)

Type: string

post_recurring_application_charges_id_usage_charges

Create a usage charge

Parameters

id (required)

Type: string

post_redirects

This operation has no parameters

post_script_tags

This operation has no parameters

post_smart_collections

This operation has no parameters

post_themes

This operation has no parameters

post_webhooks

Create a new Webhook

Parameters

format

Use this parameter to select the format to receive the data in. Valid values are json and xml. (default: json)

Type: string

put_blogs_id

Modify an existing Blog

Parameters

id (required)

Type: string

put_blogs_id_articles_id

Modify an existing Article

Parameters

article_id (required)

Type: string

blog_id (required)

Type: string

put_carrier_services_id

Modify an existing CarrierService

Parameters

id (required)

Type: string

put_comments_id

Modify an existing Comment

Parameters

id (required)

Type: string

put_countries_id

Modify an existing Country

Parameters

id (required)

Type: string

put_countries_provinces_by_id

Modify an existing Province

Parameters

country_id (required)

Type: string

province_id (required)

Type: string

put_custom_collections_id

Modify an existing CustomCollection

Parameters

id (required)

Type: string

put_customer_saved_searches_id

Modify an existing CustomerSavedSearch

Parameters

id (required)

Type: string

put_customers_id

Modify an existing Customer

Parameters

id (required)

Type: string

put_customers_id_addresses_id

Modify an existing CustomerAddress

Parameters

address_id (required)

Type: string

customer_id (required)

Type: string

put_customers_id_addresses_id_default

Sets default address for a customer

Parameters

address_id (required)

Type: string

customer_id (required)

Type: string

put_gift_cards_id

Modify an existing Gift Card

Parameters

id (required)

Type: string

put_order_fulfillments_by_id

Modify an existing Fulfillment

Parameters

fulfillment_id (required)

Type: string

order_id (required)

Type: string

put_order_risks_id

Modify an existing Order Risks

Parameters

order_id (required)

Type: string

risk_id (required)

Type: string

put_orders_id

Modify an existing Order

Parameters

id (required)

Type: string

order

Change an order’s attributes such as note, email, buyer-accepts-marketing, or remove the customer association. You can also send the shipping_address object as part of an order to update any shipping_address parameter. shipping_address - Enables you to update shipping address parameters

Type: string

put_pages_id

Modify an existing Page

Parameters

id (required)

Type: string

put_products_id

Modify an existing Product

Parameters

id (required)

Type: string

put_products_id_images_id

Modify an existing Product Image

Parameters

image_id (required)

Type: string

product_id (required)

Type: string

put_products_metafields_by_id

Update a product metafield

Parameters

field_id (required)

Type: string

product_id (required)

Type: string

put_recurring_application_charges_id_customize

Customize a recurring application charge

Parameters

id (required)

Type: string

put_redirects_id

Modify an existing Redirect

Parameters

id (required)

Type: string

put_script_tags_id

Modify an existing ScriptTag

Parameters

id (required)

Type: string

put_themes_id_assets

Creating or Modifying an Asset

Parameters

id (required)

Type: string

put_variants_id

Modify an existing Product Variant

Parameters

id (required)

Type: string

put_webhooks_id

Modify an existing Webhook

Parameters

id (required)

Type: string