# API 2025-11 changelog

Changes in API version `2025-11`. [Open the 2025-11 API reference](/reference/2025-11).

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.
