Sign in

Get RFM

GET https://{organization}.myguper.com/api/register/customer/{person}/rfm

Returns the Recency / Frequency / Monetary record for a single person — first/last purchase, lifetime value, count, cadence, and the most recent reward card received. Refreshed automatically after every order commit and whenever a reward card is issued.

Used by admin and segmentation flows to display a customer's purchasing snapshot. For listing many at once see List RFM.

Try-it values populated from environment ACME (Demo)


Authentication

Token

Send your user token in the x-guper-authorization header.

Headers

Name Type Description
x-guper-authorization * string User token issued by Guper.
Content-Type * string Always `application/json` for endpoints that accept a JSON body.

Path parameters

Name Type Description
person * integer Internal person id (`personId`).

Responses

{
    "person":                  643,
    "firstPurchaseId":         211,
    "lastPurchaseId":          1142,
    "firstPurchaseDate":       "2024-01-09T09:34:13-03:00",
    "lastPurchaseDate":        "2026-04-22T17:48:00-03:00",
    "averagePurchaseInterval": 28.4,
    "totalPurchaseValue":      398900,
    "totalPurchases":          12,
    "daysWithoutPurchase":     12,
    "lastRewardCardId":        9821,
    "lastRewardCardDate":      "2026-04-22T17:48:03-03:00",
    "nextUpdateDate":          "2026-05-04T03:00:00-03:00"
}

Related

Copied to clipboard