Anonymous peer benchmarks (k-anonymity gated)

GET

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

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

x-numu-scope:analytics:read

Your KPIs vs anonymous peer percentiles (AI-7).

Reciprocity: you see benchmarks only if your store contributes
(settings.benchmarks_opt_in). Cells are published only when
they aggregate ≥10 stores — with fewer, the response says so
honestly instead of showing numbers that could deanonymize peers.

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

Response Example

200 - Example 1

{
    "success": true,
    "data": {
        "published": true,
        "reason": "string",
        "opted_in": true,
        "period": "string",
        "benchmarks": [
            {
                "metric": "string",
                "yours": 0,
                "p25": 0,
                "p50": 0,
                "p75": 0,
                "n_stores_bucket": "string",
                "segment_used": "string"
            }
        ]
    },
    "message": "string"
}

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

Executive dashboard — what should I do today?

Custom report: metrics grouped by a chosen dimension