---
title: "Verify a SHA-256 digest against the Knox chain"
method: GET
path: "/api/knox/verify"
tags: ["public"]
---

# Verify a SHA-256 digest against the Knox chain

`GET /api/knox/verify`

## Request

- Base URL: `https://bonissystems.com`
- URL: `https://bonissystems.com/api/knox/verify`
- Auth: none declared

## Query parameters

- `hash` string, required: SHA-256 digest, 64 lowercase hex characters.

## Response `200`

Anchor found and verified.

- VerifyResponse
  - `verified` boolean, required
  - `source` 'knox-baas' | 'knox-internal': Verification path. `knox-baas` (historical wire identifier; current public name: Knox audit-permanence primitive) = Postgres-backed anchor lookup; `knox-internal` = in-memory fallback.
  - `anchor` object
    - `id` string
    - `hash` string: SHA-256 digest, 64 lowercase hex characters.
    - `eventType` string
    - `sequence` integer
    - `previousHash` string: SHA-256 digest, 64 lowercase hex characters.
    - `timestamp` string, date-time
    - `organization` string
  - `chain` object
    - `linkValid` boolean
    - `previousAnchor` object, nullable
      - `hash` string: SHA-256 digest, 64 lowercase hex characters.
      - `timestamp` string, date-time
  - `merkle` object, nullable
    - `root` string: SHA-256 digest, 64 lowercase hex characters.
    - `status` string

## Other responses

- `400`: Missing or malformed hash parameter.
- `404`: No anchor found for the given hash in the current chain.

---

[API](https://skmtc.dev/bonissystems/apis/knox-audit-permanence-primitive.md) · [All operations](https://skmtc.dev/bonissystems/apis/knox-audit-permanence-primitive/llms.txt) · [OpenAPI document](https://skmtc.dev/bonissystems/apis/knox-audit-permanence-primitive/revisions/acb182b9ec30?raw)