Required Reason: file timestamps
iOS file creation and modification time needs a reason code: C617.1, 3B52.1, DDA9.1 or 0A2A.1.
In one line
Can check file dates on iPhone only with a stated reason, and freely on Android
iOS file creation and modification time needs a reason code: C617.1, 3B52.1, DDA9.1 or 0A2A.1.
File dates can reveal install time and OS age. Reasons limit who sees them: C617.1 app container, 3B52.1 user-granted files, DDA9.1 display, 0A2A.1 SDK wrapper.
What it can and can't do
What the user does: Nothing. The app checks when it opens or syncs
It can
- Check dates on its own files, app group files or CloudKit files on iPhone
- Check dates on files you chose to give it
- Show you file dates inside the app
- Check dates on Android with no gate
It cannot
- Check dates on iPhone without one of the listed reasons
- Send the dates off your phone when the reason is only to show you
- Use the dates for tracking, under the rules
- Need a reason on Android
How it differs between platforms: Android has no gate. iPhone requires a declared reason such as C617.1 or DDA9.1.
On Android and iPhone
| Android | iPhone | |
|---|---|---|
| Status | Not supported | Behind a flag |
| First version | Not available | iOS 17.0 |
| Permission or entitlement | none | entitlement |
| Protection level | none | entitlement |
| How access is granted | not-exposed | none |
| What the user sees | Not listed | Not listed |
| How long it lasts | Not listed | Not listed |
| How to take it back | Not listed | App Review: reason must match use |
| Store policy | None listed | None listed |
| API | Android has no gate; File.lastModified is open | C617.1 app, app group or CloudKit container; 3B52.1 user-granted files; DDA9.1 show to user (no off-device send); 0A2A.1 SDK wrapper only |
| Notes | Android analog: no reason needed | None |
Data you get
What comes back: Reason codes
Shape: object
How often: At upload
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
reason_codes | list | code | 4 values | exact |
Technical limits
- Reasons restrict off-device use
The story
What it is
iOS makes apps give an approved reason before reading file dates.
For you
You never see it. File dates can reveal when you installed an app or updated the system, so Apple makes apps explain why they read them.
For makers
Makers choose a reason code, like C617.1 for their own files or 3B52.1 for files you shared. Using dates for tracking is not allowed.
Where you see it
| Type | Example | Apps |
|---|---|---|
| productivity | A notes app sorts documents by last edited date and declares C617.1. | None named |
| media | A files app shows the date of a document you opened and declares 3B52.1. | None named |
| developer | A toolkit wraps file dates for the app and declares 0A2A.1. | None named |
| utilities | A viewer app shows the date a file was made and declares DDA9.1. | None named |
| ads | A tracker SDK that reads install time through file dates is flagged. | None named |
| security | A fraud tool that reads file dates to guess phone age loses access. | None named |
Risks
- Reason may be misused
- Dates can leak install time
Android and iPhone in short
- Android: Android has no matching rule.
- iPhone: Enforced through the privacy manifest and App Store checks.
What the platform says
- Apple: Required Reason APIs. Developer rule: apps must declare why they read file creation or modification time, since dates can fingerprint a device.
Good uses and abuse
Legitimate uses
- Show file dates
Known abuse
- Install-time fingerprint
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 1 of 5 | How revealing the data is |
| Utility | 2 of 5 | How useful it is to honest apps |
| Friction | 3 of 5 | How much the user has to do |
| Fingerprint bits | Not rated | Rough identifying entropy, when known |
History
- 2024-05, iPhone iOS 17.x: Reason required to ship
Related capabilities
Related
- Required Reason APIs and privacy manifest. Can only use five fingerprint prone phone details with an approved reason on iPhone
Sources
How well checked: Checked against real behavior.