---
title: "Explain a held decision in customer-safe words"
method: GET
path: "/v1/decisions/{decisionId}/explanation"
---

# Explain a held decision in customer-safe words

`GET /v1/decisions/{decisionId}/explanation`

## Request

- Base URL: `https://api.decionis.com`
- URL: `https://api.decionis.com/v1/decisions/{decisionId}/explanation`
- Auth: HTTP bearer

Organization API key with decision:read and role VIEWER or higher; the organization comes from the key. For a HOLD, BLOCK or ESCALATE decision, returns wording a support agent can pass on (no codes, check ids or figures) and an internal part with reason codes, check ids and the dossier id. An approved decision is 409 decision_not_held.

## Response `200`

The explanation.

- DecisionExplanation
  - `version` 'decionis.decisions.explanation/1', required
  - `decision_id` string, required
  - `disposition` 'HOLD' | 'BLOCK' | 'ESCALATE', required
  - `customer_safe` object, required
    - `summary` string, required
    - `next_step` string, required
  - `internal` object, required
    - `reason_codes` string[], required
    - `check_ids` string[], required
    - `dossier_id` string, nullable, required
  - `generated_by` 'decionis.explanations.catalog/1', required

## Other responses

- `400`: Structured API error
- `403`: Structured API error
- `404`: Structured API error
- `409`: Structured API error
- `503`: Structured API error

---

[API](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api.md) · [All operations](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api/llms.txt) · [OpenAPI document](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api/revisions/357f5e459d0c?raw)