Endpoint: GET /api/v1/inventory/stock-movement

Full URL: https://api.spreetaileu.com/api/api/v1/inventory/stock-movement?start_date=2026-08-01&end_date=2026-08-21&page=1&page_size=50

Returns the total stock movement between start_date and end_date for your whole catalog, one page at a time: per SKU, stock_in, stock_out, and net_movement (which can be negative), summed across all of your warehouse locations.

Served entirely from a pre-computed nightly snapshot (refreshed 02:00 UTC), so it responds fast at any page size. Two consequences of that: dates only (YYYY-MM-DD, whole-day granularity), and end_date must be yesterday (UTC) or earlier — requests including today return 400. For live, up-to-the-minute numbers on a specific SKU use GET /api/v1/inventory/stock-movement/{sku}.

Pagination is deterministic: the catalog is sorted by SKU and sliced. Walk pages 1..total_pages to export the full catalog.

Each entry carries movement_available (false means the snapshot does not cover that SKU yet), data_as_of (when its snapshot was computed) and data_complete (false means the snapshot predates the end of the requested window, so the window's tail may be missing — never reported as a silent zero). The snapshot holds the most recent 180 days of movement.