Data Retention
What is stored
The verifier service stores the following ojects during the verification process:
PresentationSession
session metadata and auth state
SessionVerificationInformation
verification policies and redirect URIs
PolicyResults
verification results (potentially contains PII)
Retention policy
- Default expiration: 5 minutes
- Storage backend: Configurable (memory/Redis/Redis-cluster)
- Automatic cleanup: Yes, via TTL expiration
How to configure the retention policy
Per-Request TTL Override
You can override the default TTL for individual sessions via HTTP headers:
Include the sessionTtl header in your issuance request:
POST /openid4vc/verify
sessionTtl: 600
Content-Type: application/json
Body: {...}
The sessionTtl value is in seconds. Example above sets TTL to 600 seconds (10 minutes).
Storage backend
A shared storage backend is useful for distributed architectures. You can configure the storage backend to use a shared database to store session data.
In the waltid-services/waltid-issuer-api/config/persistence.conf config file, you can configure the storage backend to use a shared database to store session data.
// Default storage backend is memory.
type = "memory"
// Using redis as a shared database to store session data.
type = "redis"
nodes = [{host = "127.0.0.1", port = 6379}]
user: ""
password: ""
Last updated on August 26, 2026
