API 2025-11 changelog

Changes in API version 2025-11. Open the 2025-11 API reference.

This API version introduces pagination improvements for better performance with large datasets. This document outlines the primary changes from the previous version (2025-03).

Stock Levels API

Pagination Changes

• Cursor Pagination: The Stock Levels API now uses cursor-based pagination instead of offset-based pagination for improved performance and consistency.

Required Parameters

• Stock Levels API: Either warehouse or product query parameter is now required.
• Bundle Stock Levels API: The warehouse query parameter is now mandatory for bundle stock level queries.

Filter Changes

• Removed Filters (Stock Levels API): product_categories, product_tags, product_barcode, product_name, product_sku, product_variant_name
• Removed Ordering (Both APIs): product__sku, product__name, product__variant_name

Migration Guide

If you're migrating from version 2025-03:

1. Replace offset/limit parameters: Use cursor parameter instead of offset
2. Update pagination logic: Use next and previous cursor URLs from the response
3. Add required parameters:
   • For Stock Levels API: Include either warehouse or product query parameter
   • For Bundle Stock Levels API: Include the warehouse query parameter (mandatory)
4. Update filtering and ordering logic: Some product-related filters and ordering are no longer available

Pagination Parameters

• cursor: Use the cursor value from the response to navigate to the next/previous page
• limit: Number of items per page (default: 25, max: 100)

All other API functionality remains identical to version 2025-03, including serialization and core business logic.