How to check a workspace's whole receipt chain (GET /api/verify/chain)

Call GET /api/verify/chain?workspaceId=... with your key or a signed-in session. It checks every receipt link in that workspace and returns intact, length, head and links.

Last updated

Steps

  1. Find your workspace id

    It is receipt.workspaceId on any of your score responses.

  2. Check the chain

    curl -s "https://api.clearrun.net/api/verify/chain?workspaceId=WORKSPACE_ID" \
  -H "Authorization: Bearer $CLEARRUN_API_KEY"

  3. Read the result

    intact: true means each receipt points to the one before it and nothing in between is missing or changed. length is how many receipts. head is the latest receipt hash.

Errors

  • 400 workspaceId is required
  • 404 Workspace not found: not on your account
  • 401 or 403 as on other keyed routes

One receipt only?

Use the public lookup. See How to look up a verdict with GET /api/verify/{verdictId}.