Required Reason: disk space
iOS free and total storage need 85F4.1, E174.1, 7D9E.1 or B728.1.
In one line
Can check your free storage on iPhone only with a stated reason, and freely on Android
iOS free and total storage need 85F4.1, E174.1, 7D9E.1 or B728.1.
Exact free bytes are near-unique. 85F4.1 shows space to the user, E174.1 checks room before writing, 7D9E.1 adds to a user-sent bug report, B728.1 is for health research apps.
What it can and can't do
What the user does: Nothing. The app checks when it starts or before a download
It can
- Show you how much space is left, one allowed reason on iPhone
- Change its behavior when space is low, another allowed reason
- Include space in a bug report you send, another allowed reason
- Check space on Android with no gate at all
It cannot
- Check space on iPhone without picking one of the listed reasons
- Use the number to track you, or send it elsewhere, under the rules
- Ignore Apple's check; submissions are reviewed since 1 May 2024
- Need any reason on Android
How it differs between platforms: Android has no gate. iPhone requires one of four declared reasons.
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: no off-device use except listed |
| Store policy | None listed | None listed |
| API | Android has no gate: StatFs is open | 85F4.1 show to user (LAN to own device ok with consent); E174.1 behavior must change by space; 7D9E.1 bug report; B728.1 health research apps |
| 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
- Mostly no off-device sending
The story
What it is
iOS makes apps give an approved reason before reading free storage space.
For you
You never see this rule. It makes apps say why they check free space, so a game cannot quietly use the exact number as a tag on your phone.
For makers
Makers must pick a reason code, like 85F4.1 to show space to the user or E174.1 to check room before saving. Using the number for tracking is not allowed.
Where you see it
| Type | Example | Apps |
|---|---|---|
| media | A movie app checks free space before a download and declares reason E174.1. | None named |
| utilities | A cleaner app shows free space to you and declares reason 85F4.1. | None named |
| health | A research app that records large files declares reason B728.1. | None named |
| developer | A developer adds free space to a bug report you send, with reason 7D9E.1. | None named |
| ads | An ad SDK that reads free space for fingerprinting gets flagged and the app is rejected. | None named |
| games | A game checks room for an update download before starting it. | None named |
Risks
- Reason may be misused
- Hard to verify
Android and iPhone in short
- Android: Android has no matching rule for disk space.
- iPhone: Enforced through the privacy manifest, with checks on App Store uploads.
What the platform says
- Apple: Required Reason APIs. Developer rule: apps must declare an approved reason for using sensitive APIs like disk space, which can be used for fingerprinting.
Good uses and abuse
Legitimate uses
- Warn on low space
Known abuse
- 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
- Free and total storage. Can see free and total storage on Android, and on iPhone only with a stated reason
Same idea on the web
- Storage quotas and eviction. Can store only what your browser allows, and may lose it when space is low
Sources
How well checked: Checked against real behavior.