Skip to Content
Platform.Ontology

Required Reason: file timestamps

iOS file creation and modification time needs a reason code: C617.1, 3B52.1, DDA9.1 or 0A2A.1.

Works without askingFiles and storagePrivacy manifestsAndroid and iPhoneWhen the app opensWhile you use it

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

AndroidiPhone
StatusNot supportedBehind a flag
First versionNot availableiOS 17.0
Permission or entitlementnoneentitlement
Protection levelnoneentitlement
How access is grantednot-exposednone
What the user seesNot listedNot listed
How long it lastsNot listedNot listed
How to take it backNot listedApp Review: reason must match use
Store policyNone listedNone listed
APIAndroid has no gate; File.lastModified is openC617.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
NotesAndroid analog: no reason neededNone

Data you get

What comes back: Reason codes
Shape: object
How often: At upload

FieldTypeUnitRangePrecision
reason_codeslistcode4 valuesexact

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

TypeExampleApps
productivityA notes app sorts documents by last edited date and declares C617.1.None named
mediaA files app shows the date of a document you opened and declares 3B52.1.None named
developerA toolkit wraps file dates for the app and declares 0A2A.1.None named
utilitiesA viewer app shows the date a file was made and declares DDA9.1.None named
adsA tracker SDK that reads install time through file dates is flagged.None named
securityA 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

ScoreValueMeaning
Sensitivity1 of 5How revealing the data is
Utility2 of 5How useful it is to honest apps
Friction3 of 5How much the user has to do
Fingerprint bitsNot ratedRough identifying entropy, when known

History

  • 2024-05, iPhone iOS 17.x: Reason required to ship

Sources

How well checked: Checked against real behavior.

On this page