# Ecwid API Changelog

### February 24, 2026

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a data-mention href="february-2026/february-24/removed-script-requirement-for-generating-cart-urls">removed-script-requirement-for-generating-cart-urls</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/aRJpOy0U8IpbjUfcox4D/">Storefronts</a></td></tr><tr><td><a data-mention href="february-2026/february-24/receive-product-data-in-response-to-put-post-calls">receive-product-data-in-response-to-put-post-calls</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="february-2026/february-24/price-range-design-config">price-range-design-config</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="february-2026/february-24/features-available-on-current-plan">features-available-on-current-plan</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr></tbody></table>

### January 25, 2026

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a data-mention href="january-2026/january-25/design-config-for-compact-products">design-config-for-compact-products</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/aRJpOy0U8IpbjUfcox4D/">Storefronts</a></td></tr><tr><td><a data-mention href="january-2026/january-25/new-store-vertical-settings">new-store-vertical-settings</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="january-2026/january-25/discounted-shipping-rate-for-orders-and-carts">discounted-shipping-rate-for-orders-and-carts</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="january-2026/january-25/timestamp-of-the-latest-change-for-product-options">timestamp-of-the-latest-change-for-product-options</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr></tbody></table>

### October 16, 2025

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a data-mention href="october-2025/october-16/composite-products-feature">composite-products-feature</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="october-2025/october-16/new-site-activity-reports">new-site-activity-reports</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="october-2025/october-16/default-product-sorting-for-one-page-catalog">default-product-sorting-for-one-page-catalog</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="october-2025/october-16/unused-js-api-call-removed">unused-js-api-call-removed</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/aRJpOy0U8IpbjUfcox4D/">Storefronts</a></td></tr></tbody></table>

### September 19, 2025

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a data-mention href="september-2025/september-19/store-id-is-now-required-for-external-apps-authentication">store-id-is-now-required-for-external-apps-authentication</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/uOzT5egoVTAjMJwRuMQT/">Build apps</a></td></tr><tr><td><a data-mention href="september-2025/september-19/shipping-discount-data-in-order-details">shipping-discount-data-in-order-details</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="september-2025/september-19/tax-deduction-field-for-order-items">tax-deduction-field-for-order-items</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="september-2025/september-19/fixed-price-promotions">fixed-price-promotions</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr></tbody></table>

### August 29, 2025

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a data-mention href="august-2025/august-29/design-config-for-the-all-products-storefront-mode">design-config-for-the-all-products-storefront-mode</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/aRJpOy0U8IpbjUfcox4D/">Storefronts</a></td></tr><tr><td><a data-mention href="august-2025/august-29/design-config-for-the-filters-orientation">design-config-for-the-filters-orientation</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/aRJpOy0U8IpbjUfcox4D/">Storefronts</a></td></tr><tr><td><a data-mention href="august-2025/august-29/design-configs-for-product-swatches">design-configs-for-product-swatches</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/aRJpOy0U8IpbjUfcox4D/">Storefronts</a></td></tr><tr><td><a data-mention href="august-2025/august-29/composite-products-in-api">composite-products-in-api</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr></tbody></table>

### June 27, 2025

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a data-mention href="june-2025/june-27/trigger-promotions-with-any-product">trigger-promotions-with-any-product</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="june-2025/june-27/external-id-for-customer-groups">external-id-for-customer-groups</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr></tbody></table>

### June 13, 2025

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a data-mention href="june-2025/june-13/enable-custom-tips-with-a-store-profile-setting">enable-custom-tips-with-a-store-profile-setting</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="june-2025/june-13/new-report-type-visitors-activity-by-emails">new-report-type-visitors-activity-by-emails</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="june-2025/june-13/error-codes-for-rest-api">error-codes-for-rest-api</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="june-2025/june-13/create-and-update-combinations-with-product-calls">create-and-update-combinations-with-product-calls</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr></tbody></table>

### May 16, 2025

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a data-mention href="may-2025/may-16/get-recently-used-swatches-with-a-new-endpoint">get-recently-used-swatches-with-a-new-endpoint</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="may-2025/may-16/display-product-size-filters-as-buttons-grid">display-product-size-filters-as-buttons-grid</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="may-2025/may-16/search-orders-by-the-payment-apps-client_id">search-orders-by-the-payment-apps-client_id</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr></tbody></table>

{% hint style="warning" %}
**Breaking changes!**

Changes listed below will become backwards incompatible in the future. It's best to update payment applications now to ensure they continue working without any issues.&#x20;
{% endhint %}

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a data-mention href="may-2025/may-16/updated-encryption-mode-for-payment-api-requests">updated-encryption-mode-for-payment-api-requests</a></td><td><a data-mention href="broken-reference">Broken link</a></td></tr></tbody></table>

### April 25, 2025

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a data-mention href="april-2025/april-25/schedule-for-automatic-promotions-enabling">schedule-for-automatic-promotions-enabling</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="april-2025/april-25/delivery-pickup-precision-types">delivery-pickup-precision-types</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="april-2025/april-25/size-limit-for-order-id-prefix-and-suffix">size-limit-for-order-id-prefix-and-suffix</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr></tbody></table>

### April 11, 2025

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a data-mention href="march-2025/march-28/new-endpoints-for-managing-customer-contacts">new-endpoints-for-managing-customer-contacts</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/Q47kAA1WxNIuWGKG5OiB/">Webhook automations</a></td></tr><tr><td><a data-mention href="april-2025/april-11/bulk-update-product-reviews-with-a-new-endpoint">bulk-update-product-reviews-with-a-new-endpoint</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="april-2025/april-11/new-divider-element-for-building-custom-sections">new-divider-element-for-building-custom-sections</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/kP7oeJaJ4GqXzYswT5rn/">Site Themes</a></td></tr></tbody></table>

### March 28, 2025

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a data-mention href="march-2025/march-28/new-endpoints-for-managing-customer-contacts">new-endpoints-for-managing-customer-contacts</a></td><td><a href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="march-2025/march-28/color-swatches-as-product-options-in-ecwid-api">color-swatches-as-product-options-in-ecwid-api</a></td><td><a href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="march-2025/march-28/new-fields-to-check-storefront-url-format">new-fields-to-check-storefront-url-format</a></td><td><a href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="march-2025/march-28/new-details-in-the-ecwid.cart.get-method-from-js-api">new-details-in-the-ecwid.cart.get-method-from-js-api</a></td><td><a href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/aRJpOy0U8IpbjUfcox4D/">Storefronts</a></td></tr></tbody></table>

### March 25, 2025

New endpoints and search tools for customers in API reference.

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a href="march-2025/march-25/phone-and-address-as-query-params-for-searching-customers">Phone and address as query params for searching customers</a></td><td><a href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a href="march-2025/march-25/new-endpoints-for-customer-extra-fields">New endpoints for customer extra fields</a></td><td><a href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr></tbody></table>

### March 20, 2025

Check out the list of security changes released for Ecwid API in the last 6 months.&#x20;

These changes could break some apps, so we recommend going through the links below to ensure your application is updated or was not affected by the changes.

{% hint style="danger" %}
**Breaking changes!**\
Сhanges listed below may break some apps' logic.
{% endhint %}

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a href="march-2025/march-20/sha1-replaced-with-sha256-for-the-storefront-sso-feature">SHA1 replaced with SHA512 for the Storefront SSO feature</a></td><td><a href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a href="march-2025/march-20/discontinued-tokens-passing-in-query-params-of-api-calls">Discontinued tokens passing in query params of API calls</a></td><td><a href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a href="march-2025/march-20/new-returnurl-format-in-payment-api-with-enhanced-security">New returnUrl format in payment API with enhanced security</a></td><td><a href="broken-reference">Payment methods</a></td></tr><tr><td><a href="march-2025/march-20/oauth-for-public-apps-get-request-type-changed-to-post">OAuth for public apps: GET request type changed to POST</a></td><td><a href="https://app.gitbook.com/s/uOzT5egoVTAjMJwRuMQT/launch-apps">Launch apps</a></td></tr></tbody></table>

### March 17, 2025

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a href="march-2025/march-17/expansion-of-allowed-http-codes-for-webhook-confirmation">Expansion of allowed HTTP codes for webhook confirmation</a></td><td><a href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/Q47kAA1WxNIuWGKG5OiB/">Webhook automations</a></td></tr><tr><td><a href="march-2025/march-17/new-conditions-for-promotions">New conditions for promotions</a></td><td><a href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a href="march-2025/march-17/new-query-params-for-the-search-categories-call">New query params for the "Search categories" call</a></td><td><a href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr></tbody></table>

{% hint style="danger" %}
**Breaking changes!**\
Сhanges listed below may break some apps' logic.
{% endhint %}

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a href="march-2025/march-17/new-and-updated-values-for-discount-bases-in-orders-and-carts">Updated list of discount bases in REST API</a></td><td><a href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr></tbody></table>