---
# System prepended metadata

title: PEx Retention

---

# PEx Retention

The Retention [[ref:Feature]] extends the [[ref:Input Descriptor Object]]'s _field_ 
object, allowing a Verifier to indicate it will retain the submitted value for the
specific field.

A [[ref:Verifier]] must not retain any data, including digests, signatures,
and derived data received, except for claims from the [[ref:Presentation Submission]] descriptors
for which the accompanying [[ref:Input Descriptor Object]]'s _field_ `intent_to_retain`
property was set to true.

Retain is defined as: “to store for a period longer than necessary to conduct the
exchange between [[ref:Holder]] and [[ref:Verifier]] in realtime”.

When using this [[ref:Feature]]:
  - `retention` - The _fields_ object inside an [[ref:Input Descriptor Object]] ****MAY****
    contain an `retention` property.
    If present, its value ****MUST**** be an object that indicates the [[ref:Verifier]]
    intents to retain the [[ref:Claim]]'s data being requested. 
    If not present, this feature is not enabled.
    - _retention objects_ ****MUST**** include a `maxRetentionDate` indicating the maximum date and time
      the verifier intents to retain the particular field value
    - _retention objects_ ****MAY**** include a `minRetentionDate`, indicating the minmail date and time
      the verifier intents to retain the particular field value

```json
"retention": {
  minRetentionDate: "2022-04-20T16:42:45Z",
  maxRetentionDate: "2024-02-01T12:01:24Z"
}
```
    
    
    
    ### Questions:
    - Add a property to explicitly enable/disable intent to retain?
    - Add a purpose field?
    - Regulation link?
    