Get customer RFM segmentation

GET

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

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

x-numu-scope:analytics:read

Get customer segmentation using RFM analysis, cohort retention, and CLV.

Three SQL aggregations replace the previous 10000-order in-memory
scan: per-customer aggregates over the window, all-time first-order
per active customer (drives cohort assignment), and the customer ×
order-month matrix (drives retention). The Python side then loops
over a customer-sized set, not an order-sized one.

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-segments?days=&start_date=&end_date=&granularity=&tz=' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "success": true,
    "data": {
        "segments": [
            {
                "segment": "string",
                "count": 0,
                "percentage": 0,
                "avg_revenue": 0,
                "avg_orders": 0
            }
        ],
        "cohorts": [
            {
                "cohort": "string",
                "size": 0,
                "retention": [
                    0
                ]
            }
        ],
        "clv": {
            "avg_clv": 0,
            "median_clv": 0,
            "top_10_pct_clv": 0,
            "total_customers": 0,
            "single_order_pct": 0
        }
    },
    "message": "string"
}

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

Get revenue breakdown analytics

Get inventory analytics (sell-through, ABC, dead stock)