Integration roadmap: the org's refusal gaps as a prioritized, actionable

list — each premise the engine keeps asking for, how many refusals it blocked, its share of all refusals, and the next step…

GET /v1/decisions/refusal-roadmap

cURL

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

200

{
  "gaps": [
    {
      "blocked_refusals": 1,
      "count": 2,
      "predicate": "string",
      "recommendation": "string",
      "share_of_refusals": 1.5
    }
  ],
  "refused_decisions": 1
}

list — each premise the engine keeps asking for, how many refusals it blocked, its share of all refusals, and the next step. Turns refusals from dead-ends into ‘connect this and N% of them resolve’.

Required scope: read

Response

RefusalRoadmap

gaps · RefusalRoadmapGap[] · required

Gaps, highest-leverage first.

Show RefusalRoadmapGap

blocked_refusals · integer · required

How many refused decisions this premise blocked in the window.

count · integer · required

Back-compat alias of blocked_refusals.

predicate · string · required

The premise the engine kept asking for and not getting.

recommendation · string · required

Plain-language, actionable next step.

share_of_refusals · number (double) · required

Its share of all refusals in the window, in [0, 1].

refused_decisions · integer · required

Total refused decisions in the window (the denominator for shares).

Status codes

Code	Meaning
200	Prioritized integration roadmap
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/refusal-roadmap' \
  --header "X-API-Key: $STATESET_NSR_API_KEY"

200

{
  "gaps": [
    {
      "blocked_refusals": 1,
      "count": 2,
      "predicate": "string",
      "recommendation": "string",
      "share_of_refusals": 1.5
    }
  ],
  "refused_decisions": 1
}