Get sales forecast

GET

https://numueg.app/api/v1/stores/{store_id}/analytics/forecast

Last modified:2026-09-19 16:39:33

x-numu-scope:analytics:read

Get sales revenue forecast using Holt-Winters exponential smoothing.

Preferred source: the nightly analytics_daily_rollup table.
Fallback: aggregate orders directly when the rollup hasn't
caught up to this store yet (brand-new merchants, or the daily
cron hasn't fired since signup). The forecast service consumes a
sequence of rollup-shaped objects, so we just wrap the raw daily
rows in a tiny adapter when we use the fallback path.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Responses

🟢200

application/json

Successful Response

Bodyapplication/json

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://numueg.app/api/v1/stores//analytics/forecast?horizon=' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "success": true,
    "data": {
        "historical": [
            {
                "date": "string",
                "revenue": 0,
                "orders": 0
            }
        ],
        "forecast": [
            {
                "date": "string",
                "predicted": 0,
                "lower": 0,
                "upper": 0
            }
        ],
        "metadata": {
            "status": "string",
            "days_available": 0,
            "days_required": 0,
            "horizon_days": 0,
            "method": "string",
            "avg_daily_revenue_7d": 0,
            "forecast_total": 0,
            "forecast_daily_avg": 0,
            "trend": "string",
            "message_en": "string",
            "message_ar": "string"
        }
    },
    "message": "string"
}

Modified at 2026-09-19 16:39:33

Get AI-powered store insights

Get customer sessions list