Customer health scores + states

GET

https://numueg.app/api/v1/stores/{store_id}/analytics/customer-health

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

x-numu-scope:analytics:read

0–100 health per customer + lifecycle state (VIP … churned),
computed live over 365d of orders. Recency decays on the STORE's own
repurchase rhythm, and the monetary quintile finally participates
(the legacy RFM segmenter ignored it — D14).

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/customer-health?state=&limit=' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "success": true,
    "data": {
        "distribution": [
            {
                "state": "string",
                "count": 0
            }
        ],
        "median_gap_days": 0,
        "customers": [
            {
                "customer_id": "160c0c4b-9966-4dc1-a916-8407eb10d74e",
                "name": "string",
                "score": 0,
                "state": "string",
                "orders": 0,
                "total_spent_cents": 0,
                "days_since_last": 0
            }
        ]
    },
    "message": "string"
}

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

Get top storefront search terms

Statistical predictions (stockouts, bands, repeat, COD)