Statistical predictions (stockouts, bands, repeat, COD)

GET

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

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

x-numu-scope:analytics:read

Predictions v1 — all statistical, all self-hosted (AI-5).

Stock depletion windows (EWMA velocity + Poisson band), month-end
revenue and today's-orders bands (the forecast service's
Holt-Winters), empirical repeat-purchase probability, and COD
rejection risk with Wilson intervals + per-governorate shrinkage.
Every block carries a confidence tier; blocks without enough data
return null rather than a confident-looking guess.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path 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/predictions' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "success": true,
    "data": {
        "stockouts": [
            {
                "product_id": "string",
                "name": "string",
                "quantity": 0,
                "velocity_per_day": 0,
                "days_left": 0,
                "run_out_date": "string",
                "early_date": "string",
                "late_date": "string",
                "urgent": true,
                "confidence": "string",
                "suggested_reorder_qty": 0
            }
        ],
        "revenue_month": {
            "expected_cents": 0,
            "lower_cents": 0,
            "upper_cents": 0,
            "mtd_cents": 0,
            "remaining_days": 0,
            "confidence": "string"
        },
        "orders_today": {
            "predicted": 0,
            "lower": 0,
            "upper": 0
        },
        "repeat": {
            "customers": 0,
            "repeat_customers": 0,
            "repeat_rate_pct": 0,
            "p_next_30d_pct": 0,
            "median_gap_days": 0,
            "confidence": "string"
        },
        "cod": {
            "store_rate_pct": 0,
            "wilson_low_pct": 0,
            "wilson_high_pct": 0,
            "resolved_orders": 0,
            "pending_orders": 0,
            "pending_value_cents": 0,
            "expected_loss_cents": 0,
            "by_governorate": [
                {
                    "governorate": "string",
                    "resolved": 0,
                    "returned": 0,
                    "rate_pct": 0,
                    "shrunk_rate_pct": 0
                }
            ],
            "confidence": "string"
        },
        "generated_at": "string"
    },
    "message": "string"
}

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

Customer health scores + states

Get active advisor signals