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
This 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 December 29, 2025
