Important notice about limitations in order.count method.

We want to let you know about an important update regarding the order.count API method.

Shopify has transitioned from the REST API to the GraphQL API, and the REST API is now considered legacy. In the GraphQL API, a limitation has been introduced for queries that return the total number of orders. Specifically, if a query with filters is supposed to return more than 10,000 orders, the response will still be capped at 10,000.

To work around this limitation and provide an accurate count, we make an additional request to the REST API. However, the REST API does not support the following filters:

• financial_status_ids
• delivery_method
• tags
• customer_id
• customer_email

Because of this, when using any of these filters, the 10,000 order limit will apply.

Notice: This workaround is based on the legacy API, which can be removed by Shopify at any time. So if you're using order.count method, please don’t rely on it for anything critical. We recommend adjusting your integrations to avoid depending on it long-term. Additionally, since this is a deprecated API, you may receive notifications from Shopify about using a deprecated method.

Changes in integration with Shopify:

Added the cart.giftcard.delete method, which deactivates a gift card on the store.

Updates in integration with Squarespace.

The following changes were added:

• the product.list and product.info methods now return downloadable products, but they cannot be created, updated, or deleted.
• added support for meta_title and meta_description parameters for the product.add method.
• added support for increase_quantity and reduce_quantity parameters for the product.update method.
• added support for the product.child_item.info method.

Updates in integration with Shopline

Added tax.class.info method

Updates in integration with Magento (bridge-based).

The parameters created_from, created_to, modified_from, and modified_to have been added to the category.list method.

Updates in integration with Shopline.

Added new methods:
• cart.script.list
• cart.script.add
• cart.script.delete

Updates in integration with Squarespace.

The following changes were added:

• added news_letter_subscription and consents fields for customer.list and customer.info methods
• added new params for customer.list method:
  • find_value
  • find_where
  • sort_by
  • sort_direction
  • ids
• added order_products->options field for order.list and order.info methods
• added order_ids param for the order.list method

Changes in integration with Shopify:

Removed the output of meta fields from the custom_fields field in the product.child_item.list, product.child_item.info, product.list, and product.info methods.

Updates in integration with Etsy.

Fixed an issue where the statuses with identifiers "fully refunded" and "partially refunded" had empty name fields in the responses of the order.list and order.info methods.

Updates in integration with Shopline.

Added new parameters modified_from and modified_to for the category.list method.

Changes in integration with Ecwid:

Added support for the category.add, category.update, category.delete, category.assign, and category.unassign methods.

Updates in integration with Ecwid.

The order.update method has been added.

Changes in integration with Ecwid:

Added support for the customer.update and customer.delete methods.

Changes in integration with Wix:

Added support for the subscriber.list method.

Updates in integration with Magento (Bridge).

Fixed: An issue for bridge-based Magento 2+, where image roles were reset when updating a product.

To apply the changes, update the bridge to version 172.

Changes in integration with Shopify:

Added parameters sort_by and sort_direction to the order.list method.

The sort_by parameter accepts values: order_id, create_at, and modified_at.

Updates in integration with Ecwid.

The order.abandoned.list method has been added.

Changes in integration with OpenCart:

• Added the created_from, created_to, modified_from, and modified_to parameters to the category.list and category.count methods.

Changes in integration with Magento (bridge version):

store_id is now displayed in additional_fields in the order.abandoned.list method.

Updates in integration with Prestashop (bridge-based).

The parameters created_from, created_to, modified_from, and modified_to have been added to the category.list and category.count methods.

Ecwid Integration Updates

Added new methods: tax.class.list and tax.class.info.

Changes in integration with Shopify:

Added product.variant.update.batch method

Updates in integration with Amazon SP.

The store_id parameter was added to the webhook.create method.

Updates in integration with Ecwid.

New methods were added:

• customer.group.add
• customer.group.list

Changes in integration with BigCommerce:

• Added the product.brand.list method.
• Added the manufacturer_id parameter to the product.add, product.update, product.update.batch, and product.add.batch methods.

Updates in integration with Ecwid.

New methods were added:

• cart.coupon.add
• cart.coupon.condition.add
• cart.coupon.delete

Updates in integration with Ecwid.

New methods were added:

• catalog_price_rules.list
• catalog_price_rules.count

Changes in integration with BigCommerce:

• Added parameters search_keywords, tax_class_id, width, height, length, sku, condition, allow_display_condition, min_order_quantity, max_order_quantity, tier_prices to the product.add method.
• Added parameter tax_class_id to the product.update method.
• Added parameters advanced_prices, condition, allow_display_condition, tax_class_id, search_keywords to the product.add.batch method.
• Added parameters advanced_prices, condition, allow_display_condition, tax_class_id, search_keywords to the product.update.batch method.

Changes in integration with Ecwid:

• Added support for the product.image.add, product.image.delete, product.variant.image.add, product.variant.image.delete, category.image.add, and category.image.delete methods.

Changes in integration with Ecwid:

• Added support for the product.variant.add, product.variant.update, product.variant.delete methods.

Added the ability to configure user permissions in the App.

Wix Integration Updates

Added support for new Wix OAuth authentication using instanceId. Support for Custom Authentication (Legacy) using refresh_token. is retained.

Ecwid Integration Updates

Added new methods: cart.coupon.list and cart.coupon.count.

Changes in Shopify Integration:

• Added category_id filter for the following methods:
  • product.list
  • product.count

Note: If the read_locations scope is missing, the field additional_fields.fulfillment_service will not be available.

LightSpeed Integration Updates:

• Added new methods:
• product.image.add
• product.image.update
• product.image.delete
• product.variant.image.add

For the Ecwid integration:

• category.list and category.info: Added output of meta_title and meta_description fields.
• customer.list and customer.info: Added output of news_letter_subscription and orders_count fields, and added the group_id filter.
• order.list and order.info: Added output of refunds, customer->phone, totals, and comment fields.
• order.financial_status.list: Added new status INCOMPLETE.
• order.status.list: Added new status OUT_FOR_DELIVERY.

Changes in integration with Shopify.

The use_latest_api_version parameter has been removed for the following methods:

• product.info
• product.list
• product.count
• product.child_item.info
• product.child_item.list

Changes in Ecwid Integration

Due to updates on the Ecwid platform, the format of the order_id and id fields has changed for the following methods:

• order.list
• order.info
• Response of order.add

Additionally, the format of the order_id and id fields has also been updated for shipment-related methods:

• order.shipment.list
• order.shipment.info
• Response of order.shipment.add

Previously numerical values are now converted into strings with a prefix and suffix, which are configured in the store settings.

For the WooCommerce API integration:

• Added methods /product.brand.list.json and /product.manufacturer.add.json.
• Added the manufacturer_id parameter to the product.add and product.update methods.
• Added output of the u_brand_id and u_brand fields in the product.list and product.info methods.

Changes in integration with Ecwid:

Order product dimensions are now displayed in additional_fields in the following methods:

• order.list
• order.info

Applies to all integrations

To unify all integrations, starting from May 1, 2025, all numeric fields for the status->refund_info and refunds objects, including items (qty and refund), will be strictly positive in the response of the order.list and order.info methods.

If your integration currently uses these fields as negative values, you must update your implementation to work with their absolute values.

Our app now has a multilingual interface. You can switch between the following languages:

• English
• German
• Spanish
• French
• Italian

Added the refunds field output to order.list and order.info methods for:

• PrestaShop
• PrestaShop API-based
• Magento

Added tax.class.list method for the following integrations:

• Shopware API
• Shopware
• Opencart
• Shift4Shop

For the Etsy integration:

• Added a new parameter auto_renew to the product.add and product.update methods.
• Added a new parameter materials to the product.add and product.update methods.
• For product.add, added the specifics parameter.

Changes in integration with Squarespace:

• order.info, order.list: displayed the weight and dimensions of the order items
• cart.info: displayed the weight and dimensions units in the store information

Added the backorder_status parameter to the following methods in the Shopify integration:

• product.variant.add
• product.variant.update

Etsy Integration Updates:

• Added new parameters to the following methods:
• product.add and product.update: is_supply, is_virtual, downloadablewhen_made.
• product.update: manufacturer.

Changes in integration with Squarespace:

The field order.status.refund_info has been added to the response of the order.info and order.list methods

Changes in integration with Shopify.

Metafields are now included in the additional_fields.meta_fields field for the following methods:

• product.info
• product.list
• product.child_item.info
• product.child_item.list

Starting April 1, custom fields currently prefixed with custom_ will no longer be output directly. Instead, the required values should now be retrieved from additional_fields.meta_fields.

Added tax.class.list method for the following integrations:

• Magento
• Magento API
• WooCommerce
• WooCommerce API
• PrestaShop
• PrestaShop API
• BigCommerce

Changes in Integration with Salla:

• Added order.add method

Changes in Integration with Shopify:

• Added new field refunds->items->additional_fields->restocked for order.info and order.list method

Now the seo_url field will be displayed in the product.child_item.list method for the following integrations:

• Magento
• Magento API
• PrestaShop
• PrestaShop API
• WooCommerce
• WooCommerce API
• LightSpeed eCommerce
• Demandware (Salesforce B2C Commerce)
• Shopify
• BigCommerce

Changes in integration with Shopify:

• Added a new parameter financial_status_ids for the following methods:
  • order.list
  • order.count

Changes in integration with WooCommerce:

• Added a new parameter upc to the following methods:
  • product.add
  • product.update
  • variant.add
  • variant.update

Changes in integration with Etsy v3:

• Added production_partner_ids parameter to the following methods:
  • product.add
  • product.update
• Added production_partner_ids output to product.info and product.list methods under additional_fields.

The Miva platform has been added with the following methods:

• Cart Methods:
  • cart.info.json
• Product Methods:
  • product.info
  • product.list
  • product.update
  • product.child_item.info
  • product.child_item.list
  • product.image.add
  • product.image.delete
  • product.variant.update
• Category Methods:
  • category.info
  • category.count
  • category.list
• Order Methods:
  • order.info
  • order.list
  • order.count
  • order.financial_status.list
  • order.status.list
• Customer Methods:
  • customer.info
  • customer.list
  • customer.count

Added integration with Square (Weebly)

Changes in Integration with Walmart:

Added support for Walmart CA region.

For PrestaShop API integration:

• Added category.add method
• Added category.update method
• Added category.delete method
• Added category.assign method
• Added category.unassign method

We migrated to the newer API version "v20240601" for Shopline integration.

Because Etsy API v2 was officially sunset on April 3, 2023, we have removed our integration as well. Existing integrations with Etsy (old API) will no longer be supported or maintained. As of today, only the Etsy API v3 integration remains.

Changes in integration with Prestashop API:

Validation of parameters ean, upc, mpn and isbn on the Prestashop API has been corrected for the methods product.add, product.update, product.variant.add, and product.variant.update.

For PrestaShop integration:

• Added alias parameter to the following methods:
  • customer.add
  • customer.address.add
  • customer.update
• Added the following parameters to the customer.update method:
  • group
  • status
  • news_letter_subscription
  • gender

Added parameters for Ecwid integration:

• product.list/count - added find_where (name, description)
• product.child_item.list - added find_where (SKU)
• category.list/count - added find_where (name_or_description)
• customer.list/count - added find_where (email, first_name_or_last_name)

Changes in Integration with WooCommerce:
• Added parameter attribute_ids for attribute.list method
• Added parameter lang_id for attribute.list and attribute.info methods. Now the values of the name and values fields will depend on the specified lang_id value
• Added field additional_fields->wpml_info for attribute.list and attribute.info methods
• Added attribute.value.add, attribute.value.update and attribute.value.delete methods.
• Fixed the product.attribute.value.set method. If the option is global, it binds the corresponding translations of the option values to the product and its translations. If you specify the attribute_name + value parameter set and there is no attribute with this name, then the corresponding attribute with translations is created and immediately linked to the corresponding product translations. If the attribute is custom, then it is linked only to the translation in the specified language, and the attribute will not be duplicated for all product translations.

Changes in integration with OpenCart:

New parameters added: find_value and find_where for the following methods:

• product.list and product.count
• category.list and category.count
• customer.list and customer.count
• product.child_item.list

Changes in both integrations with PrestaShop, bridge-based and API-based:

New parameters added: find_value and find_where for the following methods:

• product.list and product.count (bridge)
• category.list and category.count (bridge)
• customer.list and customer.count (bridge/API)
• product.child_item.list (bridge/API)

We migrated to the newer API version "2024-10" for Shopify integration.

Important notice: In the latest API version, Shopify added a new access scope "read_locations". This scope is required for the proper functioning of our API methods. The affected methods are: cart.info, product.list, product.info, product.add, product.update, product.child_item.list, product.variant.add, and product.variant.update. Please take action to obtain the "read_locations" scope if your app is using these methods.

If your app does not have the "read_locations" scope, API2Cart will temporarily fall back to the previous Shopify API version to ensure the affected methods remain operational.

The new "consents" field is now displayed in the API response of the "customer.list" and "customer.info" methods for Shopify, Shopline, BigCommerce, and Wix integrations.

We also added support for the "consents" parameter in the "customer.add" and "customer.update" methods for Shopify and Shopline integrations.

We renamed the field "customer->additional_fields->consents" to "customer->additional_fields->subscription_consents". This applies to the "customer.list" and "customer.info" methods in BigCommerce.

Changes in Integration with OTTO.

Transition to the new version of Otto's API.

Affected methods: product.list, product.info, product.add, product.update.

• In product.list, the parameter count must now be greater than 10.

• The additional_fields object in the product now no longer includes the field manufacturer_name. Instead, there is a new field called manufacturer_info.

• For the product.add/product.update methods, the parameter manufacturer has been removed and replaced with the manufacturer_info parameter, which is now mandatory in product.add.

Changes in integration with WooCommerce and WooCommerce API: Introducing find_value and find_where Parameters

WooCommerce (Bridge Version):

• product.listcount - find_where now supports searching by name and description.
• category.listcount - find_where now supports searching by name and description.
• customer.listcount - find_where now supports searching by email, first name, and last name.
• product.child_item.list - find_where now supports searching by name and description. Additionally, a separate filter for SKU has been added.

WooCommerce (API Version):

• product.listcount - find_where supports name_or_description, which allows searching by both name and description simultaneously.
• category.listcount - find_where supports searching by name.
• customer.listcount - find_where supports searching by email.
• product.child_item.list - find_where supports searching by name. Additionally, a separate filter for SKU has been added.

eBay integration update:

Fixed creating another duplicate when changing product status from "disabled" to "enabled"

Added note parameter for customer.add and customer.update methods.

Added find_where and find_value parameters for customer.count and customer.list methods in BigCommerce integration.

We have introduced a new feature in the user interface under Settings -> Your Profile. A new grid has been added at the bottom of the page that allows you to manage your active sessions.

Key Highlights:

• View Active Sessions: You can now see a list of all your active sessions, including details such as device, location, and last activity time.
• Terminate Sessions: You have the ability to terminate any active session, providing better control and security over your account access.

This enhancement aims to improve your account security by enabling you to monitor and manage your active sessions directly from your profile settings.

Changes in integration with Walmart:

Fixed values in the totals object for "order.list" and "order.info" methods

Added field total for "order.list" and "order.info" methods

Changes in integration with eBay:

Added parameter package_details for method "product.update"

Added Parameters

Customer List:

• Shopline: ids and since_id
• WooCommerce: ids and since_id
• WooCommerce API: ids

Order List:

• WooCommerce: since_id
• Demandware (SfCC): since_id
• BigCommerce: since_id
• Shopware API: since_id

Product List:

• Shopware API: since_id

Changes in integration with Wallmart:

Added "cart.info" method.

Changes in integration with Woocommerce:

Added parameter shipp_phone for method "order.add"

Changes in integration with Walmart:

Added field order_products->total_price for "order.list" and "order.info" methods

Changes in integration with Woocommerce API:

Added parameter shipp_phone for method "order.add"

Changes in integration with Bigcommerce:

Added parameter is_free_shipping for methods:

• "product.add"
• "product.update"
• "product.variant.add"
• "product.variant.update"
• "product.variant.add.batch"
• "product.variant.update.batch"

Changes in integration with EBay:

Added support for isbn, ean and ups parameters for "product.variant.add" and "product.variant.update" methods

Changes in integration with Shopify:

Migration to the Shopify Admin GraphQL API for the "product.image.add" and "product.image.delete" methods. Method "product.image.add" does not support parameter "content" in the new version of the API. New API version is only available if you pass the "use_latest_api_version" parameter with a value of "true"

Changes in integration with EBay:

Added "marketplace.product.find" method.

Changes in integration with Shopify:

For the product.list, product.count and product.child_item.list methods, the ability to filter by barcode has been added. To do this, use the find_value and find_where parameters.

We have implemented the output of the "comment" field and the "additional_fields->order_notes" fields in the responses of the "order.list" and "order.info" API methods for Woocommerce API Integration.

We have implemented the output of the "variant_id" field field in the responses of the "order.shipment.list" and "order.shipment.info" API methods for Shopify Integration.

Added ids, since_id parameters to customer.list, customer.count to the integration:

• Shopify
• Shopware 5
• Shopware 6
• Shopware 6 API
• Magento 2
• Magento 2 API
• BigCommerce
• Demandware
• PrestaShop
• PrestaShop API

Changes in integration with Bigcommerce:

In the "product.list" and "product.info" methods, the data type for fields 'is_free_shipping', 'is_featured', 'is_price_hidden', 'is_condition_shown', 'is_preorder_only' in additional_fields has been changed to boolean.

Changes in integration with Amazon SP API:

Added "marketplace.product.find" method.

Added up_sell_product_ids, cross_sell_product_ids fields for product.add/update methods for WooCommerce/API integration.

Added output of up_sell_products_ids, cross_sell_products_ids fields for WooCommerce/API integration.

Changes in integration with Wix:

added "cart.coupon.list", "cart.coupon.count", "cart.catalog_price_rules.list" and "cart.catalog_price_rules.count" methods.

Changes in integration with Wix:

added "product.option.delete" and "product.option.value.delete" methods.

Changes in integration with Shopify:

Now the “product.add”, “product.update”, “product.delete”, “product.variant.add”, “product.variant.update”, and “product.variant.delete” methods work based on the latest version of the Shopify Admin GraphQL API

• cross_sell_products_id and related_products_ids parameters added for product.add/update methods.
• Added related_products_ids and cross_sell_products_ids output in the product.info/list method of Shopware 5 integration.
• Added cross_sell_products_ids output in the product.info/list method of Shopware 6/API integration.

Changes in integration with Bigcommerce:

added support for the "fixed_cost_shipping_price" parameter for the "product.add" and "product.update" methods

Fixed error "404 Not Found: The requested resource could not be found. The WooCommerce plugin may be deactivated" in integration with Woocommerce API in methods:

• "order.info"
• "order.list"

Changes in integration with Wix:

added "product.review.list" method.

Changes in integration with Wix:

added "basket.info" method.

Added support for Live Shipping Rates for integration with Opencart. The following methods have been added:

• "basket.live_shipping_service.create"
• "basket.live_shipping_service.list"
• "basket.live_shipping_service.delete"

Update in Shopline Integration:

For the "order.shipmet.add" and "order.shipmet.update" methods is now possible to create or update shipment with custom carrier.

Changes in integration with Wix:

• Added the "description" and "avail" parameters to the "category.add" and "category.update" methods
• Added field "create_at" to the "product.list" and "product.info" methods
• Added the "created_from" and "created_to" parameters to the "product.list" and "product.count" methods

Changes in integration with Wix:

• The transition to the new version of the Wix API (eCommerce API) for the "order.shipment.list" and "order.shipment.info" methods has been completed
• The transition to the new version of the Wix API (eCommerce API) for the "order.abandoned.list" method has been completed. Only cursor pagination is now supported (parameter "start" is no longer supported)
• The "order.count" method is now deprecated. Wix will stop supporting it on September 4, 2024
• Added support for method "order.update"
• The transition to the new version of the Wix API (eCommerce API) for the "order.list" and "order.info" methods has been completed. The new version of the API includes the following changes:
  • If a field has no values, it will return null (previously returned an empty string)
  • Introduced field "order_status"
  • Changed "order_product_id"
  • Added coupons (field "discounts")
  • Only supports cursor pagination
  • The fulfillment status CANCELED is absent
  • Added financial statuses: UNSPECIFIED, PARTIALLY_REFUNDED, FULLY_REFUNDED, PENDING, PARTIALLY_PAID
  • Email is missing in billing and shipping addresses in the new API version
  For a smooth transition, the new API version is only available if you pass the "use_latest_api_version" parameter with a value of "true". By default, methods work through the old API. The old API is available until September 4, 2024

Changes in Mercado Libre Integration:

For the "product.list" method, parameters "sort_by" and "sort_direction" have been added.

"sort_by" supports values: "price", "create_at", "modified_at".

• Added the 'tax_id' parameter to the 'customer.address.add' method for PrestaShop (bridge-based) integration.
• Implemented the 'customer.address.add' method for PrestaShop API integration.

Changes in integration with Prestashop (bridge-based):

• Added the "cost_price" parameter to the "product.add" and "product.variant.add" methods.
• An additional field, "cost_price," has been added to the response.

Added support for Live Shipping Rates for integration with Shopline. The following methods have been added:

• "basket.live_shipping_service.create"
• "basket.live_shipping_service.list"
• "basket.live_shipping_service.delete"

Changes in integration with OpenCart:

• Added the "tags" and "tax_class_id" parameters to the "product.add" method.
• Same fields, has been added to the response.

Updates in integration with Woocommerce (Bridge Version)

For the following methods:

• 'product.add'
• 'product.update'

The ability to create or update products using Woocommerce resources has been implemented.

Improve validation when adding Bigcommerce store:

• The validation of the 'bigcommerceapi_context' parameter has been improved.