What GET /v1/projects/:id/evidence-packs/:packId/verify re-checks against a generated evidence pack — and, importantly, what it can’t check at all.
A generated document is only useful to an auditor if it can be checked, not just trusted. /verify re-runs the checks a generated pack’s own citations imply against your live data, and reports the result honestly — including admitting when it couldn’t check something.
What it checks
Click Verify next to any completed pack on the Compliance page, or call GET /v1/projects/:id/evidence-packs/:packId/verify directly. Two independent checks run:
Content integrity — the stored document is read back and re-hashed with SHA-256. If the recomputed hash doesn’t match the hash recorded at generation time, sha256Matches is false: the stored bytes have changed since the document was generated (or the object couldn’t be read at all).
Citation survival — every source record the document cited is re-resolved against your live data, scoped to the pack’s project (or organization, for org-level sources like membership). A citation whose record is gone is reported as a divergence.
Result fields
Field
Meaning
status
The overall verdict: verified, incomplete, object_missing, hash_mismatch, or diverged (see below)
packStatus
The pack’s own status: pending, processing, completed, or failed
reason
A plain-language explanation when status isn’t verified, otherwise null
sha256Matches
true when the recomputed hash of the stored document equals the hash recorded at generation time
storedSha256 / recomputedSha256
The two hashes being compared
evidenceStillPresent
true only when zero divergences were found among checked citations — see unverifiableRefs below for what “checked” deliberately excludes
checkedRefs
Count of citations that were actually re-resolved against a live record
unverifiableRefs
Count of citations that structurally cannot be re-checked at record level
divergences
One entry per citation whose record is gone, each naming the source, id, label, and whether it’s missing or wrong_project
objectMissing
true when the stored document itself couldn’t be read back
Reading status
status
Meaning
verified
The hash matches and every checked citation still resolves
incomplete
The pack isn’t completed (still pending or processing, or it failed), or it has no stored document, so there is nothing to verify. packStatus and reason say which
object_missing
The stored document couldn’t be read back
hash_mismatch
The stored document no longer hashes to the recorded SHA-256
diverged
The hash matches, but one or more cited records no longer exist or moved
verified still doesn’t mean every citation was re-checked, so read it together with unverifiableRefs.
unverifiableRefs — read this before you trust a clean result
Not every citation in a document points at a single database row that can be looked up again later. Two kinds of citation are structurally unverifiable:
Aggregates. A “models used” citation, for example, doesn’t name one row — it names a synthetic key over an aggregate (a model, summed across a whole period). There’s no single row to re-fetch, and re-running the aggregate would just compare a number the document already printed against itself, proving nothing about whether the underlying data changed.
Certain change-timeline events. Prompt-deploy, agent-lifecycle, and externally-reported change events carry composite ids from their own source systems rather than an audit-log row. Audit-sourced change events are checkable — they resolve as ordinary audit-log citations for free.
These citations are excluded from evidenceStillPresent entirely — not counted as verified, not counted as failed. They’re reported separately, in unverifiableRefs, specifically so a document with a hundred citations, ninety of them structurally uncheckable, doesn’t come back reading like “the whole document checks out” just because the ten checkable ones passed. You — or your auditor — need to see that ninety citations were never re-checked at all, not just that the ten that could be were fine.
evidenceStillPresent: true means every checkable citation still resolves. It does not mean every citation in the document was checked. Always read unverifiableRefs alongside it: a pack reporting checkedRefs: 3 and unverifiableRefs: 340 passed a much smaller check than one reporting checkedRefs: 340 and unverifiableRefs: 3 — even though both can legitimately report evidenceStillPresent: true.
missing vs. wrong_project
When a cited record doesn’t resolve inside the pack’s own project (or org), /verify does one more lookup — unscoped, across every tenant — before deciding how to report the divergence:
missing — the record doesn’t exist anywhere. It was deleted.
wrong_project — the record still exists, just not under this project anymore.
Reporting these as two distinct reasons means “the guardrail was deleted” and “the guardrail moved to another project” don’t look like the same failure.
Failure modes that don’t error
/verify never throws for a data condition — a deleted record, a deleted storage object, or a pack that never finished generating are all results, not exceptions:
A pack whose status isn’t completed (or that has no stored object or hash yet) returns a result with everything false, 0, or empty, rather than a partial or misleading pass.
A resolver failure — a transient database error while re-checking one source — is not treated as proof those records are gone. Those citations move into unverifiableRefs for that check instead of being reported as false divergences.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Zespan","colors":{"primary":"#114BB7","light":"#6AA5FF","dark":"#0B3D9A"},"logo":{"light":"https://mintcdn.com/zespancom/-JAfJAmsmVTMMTYJ/logo/ZespanLogo_B.png?fit=max\u0026auto=format\u0026n=-JAfJAmsmVTMMTYJ\u0026q=85\u0026s=0812cd854b5cf5d8ed9f1569ee685d23","dark":"https://mintcdn.com/zespancom/-JAfJAmsmVTMMTYJ/logo/ZespanLogo_W.png?fit=max\u0026auto=format\u0026n=-JAfJAmsmVTMMTYJ\u0026q=85\u0026s=3037fb596dc40b70acef167781592ee5"},"favicon":"https://mintcdn.com/zespancom/OVq7q4R1vLkWzInd/favicon.ico?fit=max\u0026auto=format\u0026n=OVq7q4R1vLkWzInd\u0026q=85\u0026s=59708ba1e2b204c608f4b5ca1677b4db","appearance":{"default":"light"},"background":{"color":{"light":"#F6F7F8","dark":"#0D0E10"}},"navbar":{"links":[{"href":"/reference/changelog","label":"Changelog"},{"href":"https://github.com/zespan","type":"github"},{"href":"mailto:letstalk@zespan.com","label":"Book a demo"}],"primary":{"type":"button","label":"Start Free","href":"https://app.zespan.com/signup"}},"footer":{"socials":{"github":"https://github.com/zespan"},"links":[{"header":"Product","items":[{"label":"Get Started","href":"/introduction"},{"label":"Traces \u0026 Observability","href":"/dashboard/traces"},{"label":"Evaluations","href":"/dashboard/evaluations"},{"label":"Guardrails","href":"/dashboard/guardrails"}]},{"header":"Developers","items":[{"label":"SDK Overview","href":"/sdk/overview"},{"label":"Integrations","href":"/sdk/integrations/overview"},{"label":"API Reference","href":"/api-reference/introduction"},{"label":"Changelog","href":"/reference/changelog"}]},{"header":"Platform","items":[{"label":"Self-Hosting","href":"/platform/self-hosting"},{"label":"Security \u0026 Compliance","href":"/platform/security"},{"label":"AI Providers (BYOK)","href":"/platform/llm-connections"},{"label":"Billing","href":"/account/billing"}]},{"header":"Company","items":[{"label":"Contact Sales","href":"mailto:letstalk@zespan.com"},{"label":"Support","href":"mailto:support@zespan.com"},{"label":"Report a Vulnerability","href":"mailto:security@zespan.com"}]}]},"seo":{"indexing":"all"},"fonts":{"family":"Geist"},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","codeblocks":{"theme":{"light":"github-light","dark":"one-dark-pro"}},"latex":true},"contextual":{"options":["copy","view","chatgpt","claude","cursor","vscode","mcp"],"display":"header"},"metadata":{"timestamp":false},"navigation":{"global":{"anchors":[{"anchor":"Changelog","icon":"clock","href":"/reference/changelog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"zespancom","hasAudioNarration":false,"actualSubdomain":"zespancom","customDomains":["docs.zespan.com"],"gitSource":{"type":"github","owner":"zespan","repo":"zespan-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6b02db26e22a015b9404204f","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Products","count":64},{"language":"default","tag":"SDKs \u0026 Integrations","count":60},{"language":"default","tag":"API Reference","count":47},{"language":"default","tag":"Platform","count":17},{"language":"default","tag":"Tracing \u0026 Observability","count":17},{"language":"default","tag":"Agent Frameworks","count":13},{"language":"default","tag":"Compliance","count":11},{"language":"default","tag":"LLM Providers","count":10},{"language":"default","tag":"Alerts \u0026 Incidents","count":9},{"language":"default","tag":"Cost \u0026 Analytics","count":9}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"custom.css","content":"@font-face{font-family:'Geist';font-weight:400;font-style:normal;font-display:swap;src:url('https://cdn.jsdelivr.net/npm/@fontsource/geist@5/files/geist-latin-400-normal.woff2') format('woff2')}@font-face{font-family:'Geist';font-weight:500;font-style:normal;font-display:swap;src:url('https://cdn.jsdelivr.net/npm/@fontsource/geist@5/files/geist-latin-500-normal.woff2') format('woff2')}@font-face{font-family:'Geist';font-weight:600;font-style:normal;font-display:swap;src:url('https://cdn.jsdelivr.net/npm/@fontsource/geist@5/files/geist-latin-600-normal.woff2') format('woff2')}@font-face{font-family:'Geist';font-weight:700;font-style:normal;font-display:swap;src:url('https://cdn.jsdelivr.net/npm/@fontsource/geist@5/files/geist-latin-700-normal.woff2') format('woff2')}@font-face{font-family:'Geist';font-weight:800;font-style:normal;font-display:swap;src:url('https://cdn.jsdelivr.net/npm/@fontsource/geist@5/files/geist-latin-800-normal.woff2') format('woff2')}@font-face{font-family:'Geist Mono';font-weight:400;font-style:normal;font-display:swap;src:url('https://cdn.jsdelivr.net/npm/@fontsource/geist-mono@5/files/geist-mono-latin-400-normal.woff2') format('woff2')}@font-face{font-family:'Geist Mono';font-weight:500;font-style:normal;font-display:swap;src:url('https://cdn.jsdelivr.net/npm/@fontsource/geist-mono@5/files/geist-mono-latin-500-normal.woff2') format('woff2')}@font-face{font-family:'Geist Mono';font-weight:600;font-style:normal;font-display:swap;src:url('https://cdn.jsdelivr.net/npm/@fontsource/geist-mono@5/files/geist-mono-latin-600-normal.woff2') format('woff2')}code,pre,kbd,samp{font-family:'Geist Mono', ui-monospace, 'Cascadia Code', monospace!important}:root,.light{--bg-canvas: #F6F7F8;--bg-surface: #FFFFFF;--bg-sunken: #EDEEF0;--bg-overlay: rgba(15, 15, 18, 0.55);--fg-primary: #121212;--fg-secondary: #545454;--fg-tertiary: #6B6B6B;--fg-disabled: #BDBDBD;--border-subtle: rgba(18, 18, 18, 0.08);--border-default: rgba(18, 18, 18, 0.18);--border-strong: rgba(18, 18, 18, 0.30);--accent: #114BB7;--accent-hover: #0B3D9A;--accent-text: #0B3D9A;--accent-soft: rgba(17, 75, 183, 0.10);--accent-fg: #FFFFFF;--success: #3B6B29;--success-soft: rgba(59, 107, 41, 0.10);--success-fg: #FFFFFF;--success-border: rgba(59, 107, 41, 0.22);--warning: #9A5A13;--warning-soft: rgba(154, 90, 19, 0.10);--warning-fg: #FFFFFF;--warning-border: rgba(154, 90, 19, 0.22);--danger: #B2311A;--danger-soft: rgba(178, 49, 26, 0.10);--danger-fg: #FFFFFF;--danger-border: rgba(178, 49, 26, 0.22);--info: var(--accent);--info-soft: var(--accent-soft);--info-fg: var(--accent-fg);--info-border: rgba(17, 75, 183, 0.22);--elev-0: none;--elev-1: 0 1px 2px rgba(15, 15, 18, 0.04), inset 0 1px 0 rgba(255, 255, 255, 0.6);--elev-2: 0 2px 8px -2px rgba(15, 15, 18, 0.06), 0 1px 3px rgba(15, 15, 18, 0.04);--elev-3: 0 12px 32px -12px rgba(15, 15, 18, 0.10), 0 4px 12px -4px rgba(15, 15, 18, 0.06);--elev-glow: 0 0 0 1px var(--accent-soft), 0 0 32px -8px var(--accent-soft);--elev-4: 0 24px 64px -16px rgba(15, 15, 18, 0.18), 0 8px 20px -6px rgba(15, 15, 18, 0.08);--radius-xs: 4px;--radius-sm: 6px;--radius-md: 10px;--radius-lg: 14px;--radius-xl: 20px;--radius-pill: 9999px;--ease-out-quad: cubic-bezier(0.32, 0.72, 0, 1);--ease-out-expo: cubic-bezier(0.16, 1, 0.3, 1);--ease-spring-soft: cubic-bezier(0.34, 1.56, 0.64, 1);--dur-instant: 80ms;--dur-fast: 160ms;--dur-base: 240ms;--dur-slow: 420ms;--dur-page: 600ms;--lq-accent: var(--accent);--lq-success: var(--success);--lq-radius: var(--radius-md);--lq-ease: var(--dur-fast) var(--ease-out-quad)}.dark{--bg-canvas: #0D0E10;--bg-surface: #15161A;--bg-sunken: #09090B;--bg-overlay: rgba(0, 0, 0, 0.65);--fg-primary: #ECECEC;--fg-secondary: #A3A2A6;--fg-tertiary: #7C7B80;--fg-disabled: #4A4A4F;--border-subtle: rgba(236, 236, 236, 0.08);--border-default: rgba(236, 236, 236, 0.18);--border-strong: rgba(236, 236, 236, 0.30);--accent: #6AA5FF;--accent-hover: #8AB9FF;--accent-text: #6AA5FF;--accent-soft: rgba(106, 165, 255, 0.12);--accent-fg: #0D0E10;--success: #A2CC8D;--success-soft: rgba(162, 204, 141, 0.12);--success-fg: #0D0E10;--success-border: rgba(162, 204, 141, 0.22);--warning: #E0A85A;--warning-soft: rgba(224, 168, 90, 0.12);--warning-fg: #0D0E10;--warning-border: rgba(224, 168, 90, 0.22);--danger: #EF8470;--danger-soft: rgba(239, 132, 112, 0.12);--danger-fg: #0D0E10;--danger-border: rgba(239, 132, 112, 0.22);--info: var(--accent);--info-soft: var(--accent-soft);--info-fg: var(--accent-fg);--info-border: rgba(106, 165, 255, 0.22);--elev-0: none;--elev-1: 0 1px 2px rgba(0, 0, 0, 0.3), inset 0 1px 0 rgba(255, 255, 255, 0.05);--elev-2: 0 2px 8px -2px rgba(0, 0, 0, 0.4), 0 1px 3px rgba(0, 0, 0, 0.2);--elev-3: 0 12px 32px -12px rgba(0, 0, 0, 0.5), 0 4px 12px -4px rgba(0, 0, 0, 0.3);--elev-4: 0 24px 64px -16px rgba(0, 0, 0, 0.6), 0 8px 20px -6px rgba(0, 0, 0, 0.4);--elev-glow: 0 0 0 1px var(--accent-soft), 0 0 32px -8px var(--accent-soft)}.prose a{color:var(--accent-text)!important;text-decoration:none;border-bottom:1px solid var(--accent-soft);transition:border-color var(--lq-ease)}.prose a:hover{border-bottom-color:var(--accent)}.prose :not(pre)>code{background:var(--border-subtle)!important;color:var(--fg-primary)!important;border:1px solid var(--border-default)!important;border-radius:4px!important;padding:1px 5px!important;font-size:0.875em!important}pre{border-radius:var(--radius-md)!important}pre,.code-block pre.shiki,[data-component-part=\"code-block-root\"] pre.shiki{background:var(--bg-sunken)!important}[data-component-part=\"code-block-root\"]{background:var(--bg-sunken)!important}[class~=\"card\"],[data-card]{background:var(--bg-surface)!important;border-radius:var(--radius-md)!important;box-shadow:var(--elev-1)!important;transition:transform var(--dur-fast) var(--ease-out-quad),\n box-shadow var(--dur-fast) var(--ease-out-quad),\n border-color var(--dur-fast) var(--ease-out-quad)!important}[class~=\"card\"]:hover,[data-card]:hover{transform:translateY(-2px);border-color:var(--border-strong)!important;box-shadow:var(--elev-2)!important}#background-color{background:var(--bg-canvas)!important}#pagination a{background:var(--bg-surface)!important;box-shadow:var(--elev-1)!important}#pagination a:hover{border-color:var(--border-strong)!important;box-shadow:var(--elev-2)!important}[data-callout=\"note\"]{border-left-color:var(--accent)!important}[data-callout=\"tip\"]{border-left-color:var(--success)!important}[data-callout=\"warning\"]{border-left-color:var(--warning)!important}[data-callout=\"check\"]{border-left-color:var(--success)!important}.prose table{border-radius:8px!important;overflow:hidden!important}[data-component-part=\"step-number\"]>div{background:var(--accent)!important;color:var(--accent-fg)!important;font-weight:600!important}[role=\"tab\"][aria-selected=\"true\"]{color:var(--accent)!important;border-bottom-color:var(--accent)!important}::-webkit-scrollbar{width:5px;height:5px}::-webkit-scrollbar-track{background:transparent}::-webkit-scrollbar-thumb{background:var(--border-default);border-radius:3px}::-webkit-scrollbar-thumb:hover{background:var(--border-strong)}.prose{color:var(--fg-primary)!important}.prose h1{letter-spacing:-0.025em;line-height:1.15;font-weight:600!important}.prose h2{letter-spacing:-0.015em;scroll-margin-top:80px}[class~=\"frame\"],[data-frame]{border-radius:var(--radius-md)!important;overflow:hidden!important;box-shadow:var(--elev-3)!important}[class~=\"accordion\"],[data-accordion]{border-radius:8px!important;transition:border-color var(--dur-fast) var(--ease-out-quad)!important}[class~=\"accordion\"]:hover,[data-accordion]:hover{border-color:var(--border-default)!important}.accordion-group>[class~=\"accordion\"]{border-radius:0!important}#navbar,#navbar [class*=\"bg-background-light\"],#navbar [class*=\"bg-background-dark\"]{background:var(--bg-surface)!important}#navbar>div[class*=\"border-b\"]{border-color:var(--border-default)!important}#navbar,#navbar a,#navbar button{color:var(--fg-secondary)!important}#navbar a:hover{color:var(--accent)!important}#navbar nav a[class*=\"text-gray-950\"]{color:var(--fg-primary)!important;background:var(--border-default)!important}#navbar li.navbar-link a{border-color:var(--border-strong)!important}#navbar button[class*=\"rounded-full\"]{box-shadow:0 0 0 1px var(--border-strong)!important}#navbar [class~=\"bg-white\"]{background:var(--border-default)!important;color:var(--fg-primary)!important}footer{background:var(--bg-surface)!important;border-top:1px solid var(--border-default)!important}footer,footer a{color:var(--fg-secondary)!important}footer a:hover{color:var(--fg-primary)!important}footer h1,footer h2,footer h3,footer h4,footer h5,footer h6{color:var(--fg-primary)!important}footer p{color:var(--fg-primary)!important}footer{position:relative;z-index:40}@media (min-width: 1024px){footer{width:calc(100vw - max(0px, calc((100vw - 1472px) / 2)) - 308px)!important}}.breadcrumb-item{font-family:'Geist Mono', ui-monospace, 'Cascadia Code', monospace!important;font-size:10px!important;letter-spacing:0.08em!important;text-transform:uppercase!important;font-weight:600!important;color:var(--accent)!important}.breadcrumb-item a{color:inherit!important}"}]}
{"page":{"pagePath":"compliance/verification","slug":"/compliance/verification","pageMetadata":{"title":"Verification","sidebarTitle":"Verification","description":"What GET /v1/projects/:id/evidence-packs/:packId/verify re-checks against a generated evidence pack — and, importantly, what it can't check at all.","icon":"badge-check","href":"/compliance/verification"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"What GET /v1/projects/:id/evidence-packs/:packId/verify re-checks against a generated evidence pack — and, importantly, what it can’t check at all.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Table,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`A generated document is only useful to an auditor if it can be checked, not just trusted. `,_jsx(_components.code,{children:`/verify`}),` re-runs the checks a generated pack’s own citations imply against your live data, and reports the result honestly — including admitting when it couldn’t check something.`]}),`\n`,_jsx(Heading,{level:`2`,id:`what-it-checks`,children:`What it checks`}),`\n`,_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Verify`}),` next to any completed pack on the Compliance page, or call `,_jsx(_components.code,{children:`GET /v1/projects/:id/evidence-packs/:packId/verify`}),` directly. Two independent checks run:`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Content integrity`}),` — the stored document is read back and re-hashed with SHA-256. If the recomputed hash doesn’t match the hash recorded at generation time, `,_jsx(_components.code,{children:`sha256Matches`}),` is `,_jsx(_components.code,{children:`false`}),`: the stored bytes have changed since the document was generated (or the object couldn’t be read at all).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Citation survival`}),` — every source record the document cited is re-resolved against your live data, scoped to the pack’s project (or organization, for org-level sources like membership). A citation whose record is gone is reported as a `,_jsx(_components.strong,{children:`divergence`}),`.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`result-fields`,children:`Result fields`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`status`})}),_jsxs(_components.td,{children:[`The overall verdict: `,_jsx(_components.code,{children:`verified`}),`, `,_jsx(_components.code,{children:`incomplete`}),`, `,_jsx(_components.code,{children:`object_missing`}),`, `,_jsx(_components.code,{children:`hash_mismatch`}),`, or `,_jsx(_components.code,{children:`diverged`}),` (see below)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`packStatus`})}),_jsxs(_components.td,{children:[`The pack’s own status: `,_jsx(_components.code,{children:`pending`}),`, `,_jsx(_components.code,{children:`processing`}),`, `,_jsx(_components.code,{children:`completed`}),`, or `,_jsx(_components.code,{children:`failed`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`reason`})}),_jsxs(_components.td,{children:[`A plain-language explanation when `,_jsx(_components.code,{children:`status`}),` isn’t `,_jsx(_components.code,{children:`verified`}),`, otherwise `,_jsx(_components.code,{children:`null`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`sha256Matches`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`true`}),` when the recomputed hash of the stored document equals the hash recorded at generation time`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`storedSha256`}),` / `,_jsx(_components.code,{children:`recomputedSha256`})]}),_jsx(_components.td,{children:`The two hashes being compared`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`evidenceStillPresent`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`true`}),` only when zero divergences were found among `,_jsx(_components.strong,{children:`checked`}),` citations — see `,_jsx(_components.code,{children:`unverifiableRefs`}),` below for what “checked” deliberately excludes`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`checkedRefs`})}),_jsx(_components.td,{children:`Count of citations that were actually re-resolved against a live record`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`unverifiableRefs`})}),_jsx(_components.td,{children:`Count of citations that structurally cannot be re-checked at record level`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`divergences`})}),_jsxs(_components.td,{children:[`One entry per citation whose record is gone, each naming the source, id, label, and whether it’s `,_jsx(_components.code,{children:`missing`}),` or `,_jsx(_components.code,{children:`wrong_project`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`objectMissing`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`true`}),` when the stored document itself couldn’t be read back`]})]})]})]}),`\n`,_jsxs(Heading,{level:`3`,id:`reading-status`,children:[`Reading `,_jsx(_components.code,{children:`status`})]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:_jsx(_components.code,{children:`status`})}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`verified`})}),_jsx(_components.td,{children:`The hash matches and every checked citation still resolves`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`incomplete`})}),_jsxs(_components.td,{children:[`The pack isn’t `,_jsx(_components.code,{children:`completed`}),` (still pending or processing, or it failed), or it has no stored document, so there is nothing to verify. `,_jsx(_components.code,{children:`packStatus`}),` and `,_jsx(_components.code,{children:`reason`}),` say which`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`object_missing`})}),_jsx(_components.td,{children:`The stored document couldn’t be read back`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`hash_mismatch`})}),_jsx(_components.td,{children:`The stored document no longer hashes to the recorded SHA-256`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`diverged`})}),_jsx(_components.td,{children:`The hash matches, but one or more cited records no longer exist or moved`})]})]})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`verified`}),` still doesn’t mean every citation was re-checked, so read it together with `,_jsx(_components.code,{children:`unverifiableRefs`}),`.`]}),`\n`,_jsxs(Heading,{level:`2`,id:`unverifiablerefs-—-read-this-before-you-trust-a-clean-result`,children:[_jsx(_components.code,{children:`unverifiableRefs`}),` — read this before you trust a clean result`]}),`\n`,_jsx(_components.p,{children:`Not every citation in a document points at a single database row that can be looked up again later. Two kinds of citation are structurally unverifiable:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Aggregates.`}),` A “models used” citation, for example, doesn’t name one row — it names a synthetic key over an aggregate (a model, summed across a whole period). There’s no single row to re-fetch, and re-running the aggregate would just compare a number the document already printed against itself, proving nothing about whether the underlying data changed.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Certain change-timeline events.`}),` Prompt-deploy, agent-lifecycle, and externally-reported change events carry composite ids from their own source systems rather than an audit-log row. Audit-sourced change events `,_jsx(_components.em,{children:`are`}),` checkable — they resolve as ordinary audit-log citations for free.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`These citations are `,_jsxs(_components.strong,{children:[`excluded from `,_jsx(_components.code,{children:`evidenceStillPresent`}),` entirely`]}),` — not counted as verified, not counted as failed. They’re reported separately, in `,_jsx(_components.code,{children:`unverifiableRefs`}),`, specifically so a document with a hundred citations, ninety of them structurally uncheckable, doesn’t come back reading like “the whole document checks out” just because the ten checkable ones passed. You — or your auditor — need to see that ninety citations were never re-checked at all, not just that the ten that could be were fine.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`evidenceStillPresent: true`}),` means every `,_jsx(_components.strong,{children:`checkable`}),` citation still resolves. It does not mean every citation in the document was checked. Always read `,_jsx(_components.code,{children:`unverifiableRefs`}),` alongside it: a pack reporting `,_jsx(_components.code,{children:`checkedRefs: 3`}),` and `,_jsx(_components.code,{children:`unverifiableRefs: 340`}),` passed a much smaller check than one reporting `,_jsx(_components.code,{children:`checkedRefs: 340`}),` and `,_jsx(_components.code,{children:`unverifiableRefs: 3`}),` — even though both can legitimately report `,_jsx(_components.code,{children:`evidenceStillPresent: true`}),`.`]})}),`\n`,_jsxs(Heading,{level:`2`,id:`missing-vs-wrong_project`,children:[_jsx(_components.code,{children:`missing`}),` vs. `,_jsx(_components.code,{children:`wrong_project`})]}),`\n`,_jsxs(_components.p,{children:[`When a cited record doesn’t resolve inside the pack’s own project (or org), `,_jsx(_components.code,{children:`/verify`}),` does one more lookup — unscoped, across every tenant — before deciding how to report the divergence:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`missing`})}),` — the record doesn’t exist anywhere. It was deleted.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`wrong_project`})}),` — the record still exists, just not under this project anymore.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`Reporting these as two distinct reasons means “the guardrail was deleted” and “the guardrail moved to another project” don’t look like the same failure.`}),`\n`,_jsx(Heading,{level:`2`,id:`failure-modes-that-don’t-error`,children:`Failure modes that don’t error`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`/verify`}),` never throws for a data condition — a deleted record, a deleted storage object, or a pack that never finished generating are all `,_jsx(_components.em,{children:`results`}),`, not exceptions:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`A pack whose status isn’t `,_jsx(_components.code,{children:`completed`}),` (or that has no stored object or hash yet) returns a result with everything `,_jsx(_components.code,{children:`false`}),`, `,_jsx(_components.code,{children:`0`}),`, or empty, rather than a partial or misleading pass.`]}),`\n`,_jsxs(_components.li,{children:[`A resolver failure — a transient database error while re-checking one source — is not treated as proof those records are gone. Those citations move into `,_jsx(_components.code,{children:`unverifiableRefs`}),` for that check instead of being reported as false divergences.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`next-steps`,children:`Next steps`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/compliance/evidence-packs`,children:`Evidence packs`}),` — generating the document `,_jsx(_components.code,{children:`/verify`}),` checks`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/compliance/frameworks`,children:`Frameworks and controls`}),` — the SOC 2 mapping behind control evidence documents`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-light","dark":"one-dark-pro"}},"config":{},"pageMetadata":{"title":"Verification","sidebarTitle":"Verification","description":"What GET /v1/projects/:id/evidence-packs/:packId/verify re-checks against a generated evidence pack — and, importantly, what it can't check at all.","icon":"badge-check","href":"/compliance/verification"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What it checks","slug":"what-it-checks","depth":2,"children":[]},{"title":"Result fields","slug":"result-fields","depth":2,"children":[{"title":"Reading status","slug":"reading-status","depth":3,"children":[]}]},{"title":"unverifiableRefs — read this before you trust a clean result","slug":"unverifiablerefs-—-read-this-before-you-trust-a-clean-result","depth":2,"children":[]},{"title":"missing vs. wrong_project","slug":"missing-vs-wrong_project","depth":2,"children":[]},{"title":"Failure modes that don’t error","slug":"failure-modes-that-don’t-error","depth":2,"children":[]},{"title":"Next steps","slug":"next-steps","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"zespancom","siteName":"Zespan","title":"Verification - Zespan","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-22T12:08:13.224Z","originalFileLocation":"compliance/verification.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"What GET /v1/projects/:id/evidence-packs/:packId/verify re-checks against a generated evidence pack — and, importantly, what it can\u0026#x27;t check at all.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Zespan\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/zespancom/sFrhz4d5m2kObzFv/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/zespancom/sFrhz4d5m2kObzFv/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/zespancom/sFrhz4d5m2kObzFv/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/zespancom/sFrhz4d5m2kObzFv/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/zespancom/sFrhz4d5m2kObzFv/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/zespancom/sFrhz4d5m2kObzFv/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/zespancom/sFrhz4d5m2kObzFv/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/zespancom/sFrhz4d5m2kObzFv/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/zespancom/sFrhz4d5m2kObzFv/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Verification - Zespan\">\u003cmeta data-mint-head property=\"og:description\" content=\"What GET /v1/projects/:id/evidence-packs/:packId/verify re-checks against a generated evidence pack — and, importantly, what it can\u0026#x27;t check at all.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Zespan\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.zespan.com/compliance/verification\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://zespancom.mintlify.site/_mintlify/api/og/v2?division=Compliance\u0026amp;title=Verification\u0026amp;description=What+GET+%2Fv1%2Fprojects%2F%3Aid%2Fevidence-packs%2F%3ApackId%2Fverify+re-checks+against+a+generated+evidence+pack+%E2%80%94+and%2C+importantly%2C+what+it+can%27t+check+at+all.\u0026amp;theme=1fa4c4f3b615854ad8821c62\u0026amp;signature=b1161fb2a20a732d91a1967b7048735776efa4d3772c6549c7ee7c2e3066f5ab\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Verification - Zespan\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"What GET /v1/projects/:id/evidence-packs/:packId/verify re-checks against a generated evidence pack — and, importantly, what it can\u0026#x27;t check at all.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://zespancom.mintlify.site/_mintlify/api/og/v2?division=Compliance\u0026amp;title=Verification\u0026amp;description=What+GET+%2Fv1%2Fprojects%2F%3Aid%2Fevidence-packs%2F%3ApackId%2Fverify+re-checks+against+a+generated+evidence+pack+%E2%80%94+and%2C+importantly%2C+what+it+can%27t+check+at+all.\u0026amp;theme=1fa4c4f3b615854ad8821c62\u0026amp;signature=b1161fb2a20a732d91a1967b7048735776efa4d3772c6549c7ee7c2e3066f5ab\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/zespancom/sFrhz4d5m2kObzFv/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Zespan\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#114BB7\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.zespan.com/compliance/verification\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/compliance/verification.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.zespan.com/#organization\",\"name\":\"Zespan\",\"url\":\"https://docs.zespan.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/zespancom/-JAfJAmsmVTMMTYJ/logo/ZespanLogo_B.png?fit=max\u0026auto=format\u0026n=-JAfJAmsmVTMMTYJ\u0026q=85\u0026s=0812cd854b5cf5d8ed9f1569ee685d23\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.zespan.com#website\",\"name\":\"Zespan\",\"url\":\"https://docs.zespan.com\",\"publisher\":{\"@id\":\"https://docs.zespan.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.zespan.com/compliance/verification#webpage\",\"url\":\"https://docs.zespan.com/compliance/verification\",\"name\":\"Verification\",\"description\":\"What GET /v1/projects/:id/evidence-packs/:packId/verify re-checks against a generated evidence pack — and, importantly, what it can't check at all.\",\"dateModified\":\"2026-11-22T12:08:13.224Z\",\"isPartOf\":{\"@id\":\"https://docs.zespan.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.zespan.com/compliance/verification#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.zespan.com/compliance/verification#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Compliance\",\"item\":\"https://docs.zespan.com/compliance/evidence-packs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Verification\",\"item\":\"https://docs.zespan.com/compliance/verification\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.zespan.com/compliance/verification#article\",\"headline\":\"Verification\",\"name\":\"Verification\",\"description\":\"What GET /v1/projects/:id/evidence-packs/:packId/verify re-checks against a generated evidence pack — and, importantly, what it can't check at all.\",\"url\":\"https://docs.zespan.com/compliance/verification\",\"mainEntityOfPage\":{\"@id\":\"https://docs.zespan.com/compliance/verification#webpage\"},\"dateModified\":\"2026-11-22T12:08:13.224Z\",\"publisher\":{\"@id\":\"https://docs.zespan.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.zespan.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Zespan\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Zespan\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/compliance/verification.md","siteName":"Zespan","nav":{"global":{"anchors":[{"anchor":"Changelog","icon":"clock","href":"/reference/changelog"}]},"tabs":[{"tab":"Get Started","pages":[{"title":"Get Started","href":"/introduction"}]},{"tab":"Products","groups":[{"group":"The Agent","pages":[{"title":"Navigation — the sidebar, grouped by the maintenance loop","sidebarTitle":"Navigation","icon":"compass","href":"/dashboard/navigation"},{"title":"Home — what the agent found and what it needs from you","sidebarTitle":"Home","icon":"house","href":"/dashboard/home"},{"title":"Needs you — decisions the agent won't make alone","sidebarTitle":"Needs you","icon":"bell","href":"/dashboard/needs-you"},{"title":"Notifications: the daily digest and where it goes","sidebarTitle":"Notifications","icon":"envelope","href":"/dashboard/notifications"},{"title":"Activity — everything the agent did","sidebarTitle":"Activity","icon":"clock","href":"/dashboard/activity"}]},{"group":"Tracing \u0026 Observability","pages":[{"title":"Traces — inspect every agent run and its steps","sidebarTitle":"Traces","icon":"git-branch","href":"/dashboard/traces"},{"title":"Environments — filter traces, evaluations, and guardrails by deployment stage","sidebarTitle":"Environments","icon":"stack","href":"/dashboard/environments"},{"title":"Sessions — track multi-turn user conversations","sidebarTitle":"Sessions","icon":"layers","href":"/dashboard/sessions"},{"title":"Agents","sidebarTitle":"Agents","icon":"bot","href":"/dashboard/agents"},{"title":"Agent Registry","sidebarTitle":"Agent Registry","icon":"book-user","href":"/dashboard/agent-registry"},{"title":"Tools","sidebarTitle":"Tools","icon":"wrench","href":"/dashboard/tools"},{"title":"Tool drift — when a tool, key or quota changes under your agents","sidebarTitle":"Tool drift","icon":"wrench","href":"/dashboard/tool-drift"},{"title":"Performance — latency metrics and throughput analysis","sidebarTitle":"Performance","icon":"gauge","href":"/dashboard/performance"},{"title":"Instrumentation — what Zespan can see, and who gets each layer","sidebarTitle":"Instrumentation","icon":"radar","href":"/dashboard/instrumentation"},{"title":"Anomaly Detection — catch metric deviations before they become incidents","sidebarTitle":"Anomaly Detection","icon":"sparkles","href":"/dashboard/ai-features"},{"title":"Span kinds reference","sidebarTitle":"Span kinds","icon":"list-tree","href":"/reference/span-kinds"},{"title":"Stack layers — where a failure started","sidebarTitle":"Stack layers","icon":"layers","href":"/reference/stack-layers"},{"title":"Finish outcome reference","sidebarTitle":"Finish outcomes","icon":"flag-checkered","href":"/reference/finish-outcomes"},{"title":"Silent-failure coverage","sidebarTitle":"Silent-failure coverage","icon":"shield-check","href":"/reference/silent-failure-coverage"},{"title":"Capture fields","sidebarTitle":"Capture fields","icon":"list-checks","href":"/reference/capture-fields"},{"title":"Manual spans — tracing custom operations","sidebarTitle":"Manual spans","icon":"code","href":"/sdk/manual-spans"},{"title":"Agent tracing — withAgent and multi-agent systems","sidebarTitle":"Agent tracing","icon":"workflow","href":"/sdk/agent-tracing"}]},{"group":"Evaluations","pages":[{"title":"Evaluations — measure and trend custom LLM metrics","sidebarTitle":"Evaluations","icon":"check-check","href":"/dashboard/evaluations"}]},{"group":"Datasets \u0026 Experiments","pages":[{"title":"Datasets","sidebarTitle":"Datasets","icon":"database","href":"/dashboard/datasets"},{"title":"HTTP Targets","sidebarTitle":"HTTP Targets","icon":"webhook","href":"/dashboard/http-targets"},{"title":"Canary — scheduled test runs","sidebarTitle":"Canary","icon":"dove","href":"/dashboard/canary"},{"title":"Dataset runs — running your pipeline over a dataset with the SDK","sidebarTitle":"Dataset runs","icon":"database","href":"/sdk/dataset-runs"},{"title":"Simulations — test LLM behavior before shipping","sidebarTitle":"Simulations","icon":"play","href":"/dashboard/simulations"},{"title":"Annotation Queues","sidebarTitle":"Annotations","icon":"clipboard-check","href":"/dashboard/annotation-queues"}]},{"group":"Guardrails","pages":[{"title":"Guardrails — configure content safety policies","sidebarTitle":"Guardrails","icon":"shield","href":"/dashboard/guardrails"},{"title":"Policies — author and apply guardrail policies from the dashboard","sidebarTitle":"Policies","icon":"shield-check","href":"/dashboard/policies"},{"title":"Policy as code — manage guardrails from git","sidebarTitle":"Policy as code","icon":"file-code","href":"/policies/as-code"},{"title":"Policy file reference","sidebarTitle":"File reference","icon":"list-check","href":"/policies/file-reference"},{"title":"Testing a policy before you enforce it","sidebarTitle":"Policy testing","icon":"flask","href":"/policies/testing"},{"title":"Local policy evaluation","sidebarTitle":"Local evaluation","icon":"bolt","href":"/policies/local-evaluation"},{"title":"Guardrails — content checking for LLM calls","sidebarTitle":"Guardrails","icon":"shield","href":"/sdk/guardrails"},{"title":"Confirmations — recording that your app asked first","sidebarTitle":"Confirmations","icon":"circle-check","href":"/sdk/confirmations"}]},{"group":"Prompt Management","pages":[{"title":"Prompts — version, deploy, and gate your prompt library","sidebarTitle":"Prompts","icon":"message-square-text","href":"/dashboard/prompts"},{"title":"Playground — compare a prompt across models side-by-side","sidebarTitle":"Playground","icon":"flask-conical","href":"/dashboard/playground"},{"title":"Blast Radius — what breaks if you change this","sidebarTitle":"Blast Radius","icon":"share-2","href":"/dashboard/blast-radius"},{"title":"Prompt management — versioned prompts with the SDK","sidebarTitle":"Prompt management","icon":"message-square-text","href":"/sdk/prompt-management"},{"title":"CI quality gate — zespan-gate CLI","sidebarTitle":"CI/CD (zespan-gate)","icon":"terminal","href":"/sdk/cli"}]},{"group":"Alerts \u0026 Incidents","pages":[{"title":"Alerts","sidebarTitle":"Alerts","icon":"bell","href":"/dashboard/alerts"},{"title":"Incidents — detect, correlate, and resolve LLM issues","sidebarTitle":"Incidents","icon":"siren","href":"/dashboard/incidents"},{"title":"Issues — recurring failures grouped automatically","sidebarTitle":"Issues","icon":"bug","href":"/dashboard/issues"},{"title":"Agent runs: watch Zespan investigate an issue","sidebarTitle":"Agent runs","icon":"magnifying-glass","href":"/dashboard/agent-runs"},{"title":"Findings — silent failures with cause, fix and prevention","sidebarTitle":"Findings","icon":"magnifying-glass","href":"/dashboard/findings"},{"title":"Detector packs — which checks run on your project","sidebarTitle":"Detector packs","icon":"crosshairs","href":"/dashboard/detector-packs"},{"title":"How a prevention draft gets proven","sidebarTitle":"How drafts get proven","icon":"shield-check","href":"/dashboard/prevent-proven"},{"title":"Detectors — choose your packs and confirm your tools","sidebarTitle":"Detectors","icon":"crosshair","href":"/dashboard/detectors"},{"title":"Changes — a project-wide timeline of what changed and when","sidebarTitle":"Changes","icon":"history","href":"/dashboard/changes"}]},{"group":"Compliance","pages":[{"title":"Evidence Packs — audit-ready compliance documents","sidebarTitle":"Evidence Packs","icon":"shield-check","href":"/compliance/evidence-packs"},{"title":"Frameworks and controls","sidebarTitle":"Frameworks","description":"The framework mappings control evidence documents support — SOC 2, the EU AI Act, and ISO/IEC 42001 — what each control's evidence comes from, and which items you supply yourself.","icon":"list-checks","href":"/compliance/frameworks"},{"title":"Verification","sidebarTitle":"Verification","icon":"badge-check","href":"/compliance/verification"}]},{"group":"Cost \u0026 Analytics","pages":[{"title":"System Health — your agent health at a glance","sidebarTitle":"Overview","description":"The System Health page shows a verdict banner judged against your own thresholds, golden-signal KPI cards, a triage row, and five drill-down tabs — all in one place.","icon":"layout-dashboard","href":"/dashboard/overview"},{"title":"Costs — understand and control your LLM spend","sidebarTitle":"Costs","icon":"coins","href":"/dashboard/costs"},{"title":"Models — per-model usage, reliability, and latency","sidebarTitle":"Models","icon":"server","href":"/dashboard/models"},{"title":"Model Lifecycle — provider deprecation radar","sidebarTitle":"Model Lifecycle","icon":"hourglass","href":"/dashboard/model-lifecycle"},{"title":"Value — business outcomes attributed to agents and models","sidebarTitle":"Value","icon":"trophy","href":"/dashboard/value"},{"title":"Outcomes — reporting business results back to a trace","sidebarTitle":"Outcomes","icon":"target","href":"/sdk/outcomes"},{"title":"Errors","sidebarTitle":"Errors","icon":"octagon-alert","href":"/dashboard/errors"},{"title":"Supported models and pricing","sidebarTitle":"Models \u0026 pricing","icon":"cpu","href":"/reference/models"},{"title":"Model lifecycle feed","sidebarTitle":"Model lifecycle feed","icon":"list-checks","href":"/reference/model-lifecycle-feed"}]},{"group":"ZespanPilot (AI Copilot)","pages":[{"title":"ZespanPilot — AI copilot for your LLM operations","sidebarTitle":"ZespanPilot","icon":"wand-2","href":"/dashboard/zespanpilot"}]}]},{"tab":"SDKs \u0026 Integrations","pages":[{"title":"SDKs \u0026 Integrations","href":"/sdk/overview"}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/guides/zespan-mcp"}]},{"tab":"Platform","pages":[{"title":"Platform","href":"/platform/llm-connections"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]}]},"basePath":"","title":"Verification - Zespan","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}