Skip to content
StratumStratum Docs

Verify the hash chain over a time range.

GET
/v1/audit/integrity/verify
Code sample: Shell / cURL
curl --request GET \
  --url 'https://stratum.example.com/v1/audit/integrity/verify?from=2026-04-15T12%3A00%3A00Z&to=2026-04-15T12%3A00%3A00Z' \
  --header 'Authorization: Bearer <token>'

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
from
required
string format: date-time
to
required
string format: date-time

Responses

Section titled “Responses”

200

Section titled “200”

Chain verifies clean.

Media typeapplication/json
object
verified
required
boolean
rangeStart
required
string format: date-time
rangeEnd
required
string format: date-time
eventCount
required
integer format: int64
firstMismatchAt
string format: date-time
firstMismatchEventId
string
expectedHash
string
observedHash
string
interpretation
string

Example generated

{
  "verified": true,
  "rangeStart": "2026-04-15T12:00:00Z",
  "rangeEnd": "2026-04-15T12:00:00Z",
  "eventCount": 1,
  "firstMismatchAt": "2026-04-15T12:00:00Z",
  "firstMismatchEventId": "example",
  "expectedHash": "example",
  "observedHash": "example",
  "interpretation": "example"
}

422

Section titled “422”

Chain verification failed.

Media typeapplication/json
object
verified
required
boolean
rangeStart
required
string format: date-time
rangeEnd
required
string format: date-time
eventCount
required
integer format: int64
firstMismatchAt
string format: date-time
firstMismatchEventId
string
expectedHash
string
observedHash
string
interpretation
string

Example generated

{
  "verified": true,
  "rangeStart": "2026-04-15T12:00:00Z",
  "rangeEnd": "2026-04-15T12:00:00Z",
  "eventCount": 1,
  "firstMismatchAt": "2026-04-15T12:00:00Z",
  "firstMismatchEventId": "example",
  "expectedHash": "example",
  "observedHash": "example",
  "interpretation": "example"
}