---
title: "One finding explained: rule and revision, compared fetches, valid time, Merkle proof of the decision in the signed manifest"
method: GET
path: "/api/explain"
---

# One finding explained: rule and revision, compared fetches, valid time, Merkle proof of the decision in the signed manifest

`GET /api/explain`

## Request

- Base URL: `https://crawlcheck.io`
- URL: `https://crawlcheck.io/api/explain`
- Auth: none required

## Query parameters

- `id` string
- `domain` string
- `code` string
- `path` string

## Response `200`

explanation

- object, nullable
  - `ok` boolean, nullable
  - `kind` string, nullable
  - `version` string, nullable
  - `subject` object, nullable
    - `domain` string, nullable
    - `host` string, nullable
    - `report_id` string, nullable
    - `scanned_at` string, nullable
  - `finding` object, nullable
    - `fid` string, nullable
    - `decision_id` string, nullable
    - `code` string, nullable
    - `severity` number, nullable
    - `path` string, nullable
    - `title` string, nullable
    - `detail` unknown
    - `meaning` unknown
  - `rule` object, nullable
    - `code` string, nullable
    - `revision` number, nullable
    - `revision_note` unknown
    - `score_version` number, nullable
    - `decided_in` object, nullable
      - `trace_id` string, nullable
      - `span_id` string, nullable
  - `observed` object, nullable
    - `evidence` object, nullable
      - `shadowed_groups` number, nullable
      - `agents_affected` number, nullable
      - `search_engines_affected` number, nullable
      - `sample` object[], nullable
    - `compared_fetches` unknown
    - `support_scope` string, nullable
  - `corroboration` object, nullable
    - `status` string, nullable
    - `reading` string, nullable
  - `trust` object, nullable
    - `freshness` object, nullable
      - `observed_at` string, nullable
      - `last_observed` string, nullable
      - `held_since` string, nullable
      - `state` string, nullable
    - `confidence` object, nullable
      - `level` string, nullable
      - `means` string, nullable
      - `basis` string[], nullable
    - `contradictions` unknown[], nullable
      - unknown
  - `score_effect` object, nullable
    - `decision_id` string, nullable
    - `code` string, nullable
    - `path` string, nullable
    - `severity` number, nullable
    - `level` string, nullable
    - `points` number, nullable
    - `cap` string, nullable
    - `binding` boolean, nullable
    - `letter_now` string, nullable
    - `letter_without_it` string, nullable
    - `same_level_others` number, nullable
    - `says` string, nullable
  - `held` object, nullable
    - `state` string, nullable
    - `first_seen` string, nullable
    - `scans_seen` number, nullable
    - `valid_time` object, nullable
      - `valid_from` object, nullable
        - `after` unknown
        - `by` string, nullable
      - `valid_to` unknown
      - `recorded_at` string, nullable
      - `superseded_at` unknown
      - `superseded_by` unknown
      - `earlier_intervals` number, nullable
      - `before_bt1` boolean, nullable
    - `history` string, nullable
  - `proof` object, nullable
    - `in_signed_manifest` boolean, nullable
    - `manifest_sha256` string, nullable
    - `decision_root` string, nullable
    - `leaf` string, nullable
    - `path` object[], nullable
      - `side` string, nullable
      - `hash` string, nullable
    - `how` unknown
  - `check` object, nullable
    - `verify` string, nullable
    - `bundle` string, nullable
    - `offline_verifier` string, nullable
  - `access` string, nullable

## Other responses

- `403`: locked: needs a licence for the domain
- `404`: no record or finding

---

[API](https://skmtc.dev/crawlcheck/apis/crawlcheck-api.md) · [All operations](https://skmtc.dev/crawlcheck/apis/crawlcheck-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlcheck/apis/crawlcheck-api/revisions/57acbd6d4489?raw)
