> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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…

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`

<ResponseField name="gaps" type="RefusalRoadmapGap[]" required>
  Gaps, highest-leverage first.

  <Expandable title="RefusalRoadmapGap">
    <ResponseField name="blocked_refusals" type="integer" required>
      How many refused decisions this premise blocked in the window.
    </ResponseField>

    <ResponseField name="count" type="integer" required>
      Back-compat alias of `blocked_refusals`.
    </ResponseField>

    <ResponseField name="predicate" type="string" required>
      The premise the engine kept asking for and not getting.
    </ResponseField>

    <ResponseField name="recommendation" type="string" required>
      Plain-language, actionable next step.
    </ResponseField>

    <ResponseField name="share_of_refusals" type="number (double)" required>
      Its share of all refusals in the window, in \[0, 1].
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="refused_decisions" type="integer" required>
  Total refused decisions in the window (the denominator for shares).
</ResponseField>

### 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 |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.nsr.stateset.com/v1/decisions/refusal-roadmap' \
    --header 'X-API-Key: YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "gaps": [
      {
        "blocked_refusals": 1,
        "count": 2,
        "predicate": "string",
        "recommendation": "string",
        "share_of_refusals": 1.5
      }
    ],
    "refused_decisions": 1
  }
  ```
</ResponseExample>