GET
/v1/protocol/dossiers/:dossierId?org_id=<org_uuid>API keyRetrieve the authoritative stored dossier row for an org-scoped caller.
Loading…
API documentation
Decision Dossier
Every governed Decionis outcome resolves to a Decision Dossier. Consumers can retrieve the stored dossier through an org-scoped route, verify it through a share-safe public route, or request a portable artifact for downstream transport. Policy Snapshot, Decision Chain, and Decision Ledger evidence preserve the authority record around the dossier. Use validation packs when the requirement is org-level regulator evidence instead of one per-decision artifact.
Routes
Choose the route that matches the caller's trust boundary.
GET
/v1/public/decision-dossiers/:dossierId/verify?sig=<signature>PublicVerify a dossier through a share-safe public route without exposing the full org-scoped artifact.
GET
/v1/orgs/:orgId/decision-dossiers/:dossierId/portableAPI keyReturn the transport-ready portable dossier payload for external delivery or storage.
Artifact shape
The Decision Dossier is the evidence surface for what Decionis decided and why.
| Field | Meaning |
|---|---|
| dossier_id | Stable dossier identifier. |
| decision_class | Governed outcome class returned by Decionis. |
| policy_version | Policy graph or policy bundle version in force. |
| signal_context | Signals accepted into the governed evaluation. |
| verification | Integrity, signature, and artifact matching state. |
Evidence boundary
Use the smallest evidence surface that satisfies the reviewer.
| Surface | Best use |
|---|---|
| Decision Dossier | One decision, one case, one governed outcome. |
| Portable dossier | Move one decision artifact into an external system or record. |
| Validation pack | Org-level export and regulator evidence. See /docs/validation-packs. |
Verification
Public verification should be safe to share. Full artifact retrieval should stay org-scoped.
{
"verified": true,
"verification_status": {
"overall": "VERIFIED",
"signature_verified": true,
"policy_snapshot_verified": true,
"chain_integrity_verified": true,
"proof_bundle_verified": true
},
"dossier": {
"dossier_id": "dd_123",
"outcome": "APPROVE",
"policy_version": "study-abroad-eligibility-v1"
},
"integrity": {
"payload_sha256": "9d4c...",
"ledger_entry_hash": "f0a1...",
"chain_integrity_verified": true
}
}Key rotation
Decision Dossier proofs are designed for long-lived audit review while allowing signing keys to rotate.
| Field | Semantics |
|---|---|
| signature_verified | The public verifier signature matched the dossier integrity envelope for the current route. |
| policy_snapshot_verified | The signed dossier includes the policy version plus an immutable bundle or parameter digest. |
| chain_integrity_verified | The dossier ledger entry reports a verified hash-chain state at evaluation time. |
| proof_bundle_verified | A persisted Ed25519 proof bundle exists for portable artifacts and advertises its JWKS path. |
| rotation_policy | JWKS overlap keeps the active key and previous keys available during the verification grace period. |