Skip to main content

Managing Claim Data

Claim data shared by wallet holders during verification is retained in the system until you delete it. You are responsible for managing this data appropriately.

There are two ways to delete claim data: automatic expiration configured at the proof schema level, and manual deletion.

Automatic expiration​

Set an expireDuration on a proof schema to automatically delete claim data after a specified period. All proof requests made using that schema will have their claim data deleted once the duration has passed.

See Proof Schemas: Data Retention for how to configure expireDuration.

info

Automatic expiration requires the RETAIN_PROOF_CHECK task to run on a schedule.

When claim data is deleted, whether by expiration or manually, the system:

  • Deletes all claim values from the proof request
  • Deletes credential information such as issuer and holder identifiers
  • Adds claimsRemovedAt to the proof request
  • Creates a history entry (entityType: PROOF, action: CLAIMS_REMOVED)

Proof request metadata is retained, including what was requested, when the transaction occurred, and when the claim data was deleted.

Manual deletion​

Delete claim data from a specific proof request at any time:

curl -L -X DELETE \
'/api/proof-request/v1/{{PROOF-REQUEST-UUID}}/claims' \
-H 'Authorization: Bearer <TOKEN>'