explain_scan
Fetch detailed audit trail for any previous token scan to understand the reasoning behind its risk verdict. Use for compliance, post-mortems, or user-facing explanations.
Instructions
Fetch the per-heuristic audit trail of a previous scan.
Costs $0.005 USDC. Use this when you need to know why a scan returned a specific verdict — e.g. for compliance, post-mortems, or building a user-visible explanation.
Args:
scan_id: UUID returned by a prior scan_token call.
Returns:
On success: {scan_id, scanned_at, score, verdict, heuristic_results: [...]}.
On failure: {error, message}. Same error codes as scan_token.
In demo mode: returns a canned audit trail keyed by the scan_id
suffix (`demo-safe-01`, `demo-caution-01`, `demo-critical-01`).
Unknown scan_ids return a demo-safe trail. Response has `_demo: true`.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scan_id | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||