Per-rule cited-vs-noise usage over a window — the demotion signal. A rule

with high noise_count and near-zero cited_count fires on every decision without ever being relevant; the response is ordered noisiest-first…

GET /v1/decisions/rule-stats

cURL

curl --request GET \
  --url 'https://api.nsr.stateset.com/v1/decisions/rule-stats' \
  --header "X-API-Key: $STATESET_NSR_API_KEY"

200

[
  {
    "cited_count": 1,
    "noise_count": 1,
    "rule": "string"
  }
]

with high noise_count and near-zero cited_count fires on every decision without ever being relevant; the response is ordered noisiest-first.

Required scope: read

Response

RuleUsageStat[] — each element:

cited_count · integer · required

noise_count · integer · required

rule · string · required

Status codes

Code	Meaning
200	Per-rule cited/noise usage
401	Unauthorized — missing or invalid credentials
403	Forbidden — the key/token lacks the required scope
429	Rate limited — see Retry-After / X-RateLimit-Reset

cURL

curl --request GET \
  --url 'https://api.nsr.stateset.com/v1/decisions/rule-stats' \
  --header "X-API-Key: $STATESET_NSR_API_KEY"

200

[
  {
    "cited_count": 1,
    "noise_count": 1,
    "rule": "string"
  }
]