List sales forecasts
Returns a paginated list of sales forecasts with explicit date-range control (forecastDateFrom/forecastDateTo). Use this endpoint for arbitrary date windows, batch queries, or when you already know the exact date bounds. For rolling horizon-relative queries (e.g. ‘next 30 days’), prefer /api/forecasts which derives the window from a horizon parameter automatically. Forecasts are keyed per variant × size × shop × date combination. Supports single-value (variantId/shopId) or comma-separated multi-value (variantIds/shopIds) filters.
Authorizations
User session token issued by NextAuth. For human users accessing Solya via the web application.
Query Parameters
Page number, 1-indexed (default: 1)
1 <= x <= 9007199254740991Number of items per page, max 100 (default: 20)
1 <= x <= 100Filter by a single variant ID (use variantIds for multiple)
Comma-separated list of variant IDs to filter by (e.g. uuid-1,uuid-2). Ignored when variantId is set.
Filter by size taxonomy ID
Filter by a single shop ID (use shopIds for multiple)
Comma-separated list of shop IDs to filter by (e.g. uuid-1,uuid-2). Ignored when shopId is set.
Forecast time granularity: DAY, WEEK, MONTH, or QUARTER. Note: WEEK granularity may return 0 rows when the data warehouse has not yet computed weekly aggregations for the requested date range.
DAY, WEEK, MONTH, QUARTER Inclusive lower bound on forecast date, ISO-8601 format YYYY-MM-DD (e.g. 2025-09-01)
^\d{4}-\d{2}-\d{2}$Inclusive upper bound on forecast date, ISO-8601 format YYYY-MM-DD (e.g. 2025-12-31)
^\d{4}-\d{2}-\d{2}$
