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