Required Reason APIs and privacy manifest
Apple requires apps to declare why they use 5 fingerprint-prone API groups, in a privacy manifest file.
In one line
Can only use five fingerprint prone phone details with an approved reason on iPhone
Apple requires apps to declare why they use 5 fingerprint-prone API groups, in a privacy manifest file.
Apps must list approved reasons per group in PrivacyInfo.xcprivacy or App Store Connect rejects the upload. Reasons limit use; fingerprinting is banned even with consent.
What it can and can't do
What the user does: Nothing. Apple checks the reasons when the developer uploads the app
It can
- Use file times, boot time, disk space, active keyboards and saved settings, with a listed reason
- List the reasons in the privacy manifest file
- Pass review when reasons match how the app works
It cannot
- Use these details to fingerprint you, even with consent
- Be uploaded to the App Store with missing reasons
- Apply on Android; Play uses Data safety and reviews instead
How it differs between platforms: iPhone only (iOS 17 and later). Android has no required reason list.
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 | not-exposed | 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 5.1.2: fingerprinting banned |
| Store policy | None listed | None listed |
| API | No equivalent; Play data safety form is looser | 5 categories (file timestamp, boot time, disk space, active keyboards, user defaults) and 17 reason codes; enforced 2024-05-01 |
| Notes | Play uses the Data safety section and policy reviews, not per-API reasons | None |
Data you get
What comes back: Manifest
Shape: object
How often: At upload
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
categories | integer | count | 5 | exact |
reason_codes | integer | count | 17 | exact |
Technical limits
- Third-party SDKs need their own manifests
The story
What it is
The rule that iOS apps must declare why they use certain fingerprint prone APIs, in a privacy file.
For you
You do not see it. It is a rule that makes apps declare why they check things like how much disk space you have.
For makers
Apps must list approved reasons per group in PrivacyInfo.xcprivacy, or App Store Connect rejects the upload. Reasons limit use, and fingerprinting is never an approved reason.
Where you see it
| Type | Example | Apps |
|---|---|---|
| games | A game states that it reads free space only to decide which art to download. | Genshin Impact |
| ads | An ad SDK drops a check of boot time to avoid a rejection. | AppLovin |
| analytics | An analytics SDK says it uses uptime only for app speed numbers. | Firebase |
| social | A photo app states it reads file dates only to sort a gallery. | |
| security | Apple reviewers compare declared reasons with real use. | None named |
| developer | A developer runs the privacy report in Xcode to find missing reasons. | None named |
Risks
- Self reported
- Reasons can be loosely stated
Android and iPhone in short
- Android: Android has no equal. Policy and API limits handle it.
- iPhone: Enforced when the build is uploaded.
What the platform says
- Apple: Required reason API. Apps must list approved reasons for using certain APIs in the privacy manifest.
Good uses and abuse
Legitimate uses
- Compliance
Known abuse
- None
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 1 of 5 | How revealing the data is |
| Utility | 3 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
- 2023-06, iPhone iOS 17: Privacy manifests and Required Reason APIs announced at WWDC
- 2024-05, iPhone iOS 17.5: Missing reasons cause App Store rejection from 2024-05-01
Related capabilities
Related
- Required Reason: file timestamps. Can check file dates on iPhone only with a stated reason, and freely on Android
- Required Reason: system boot time. Can check how long the phone has been on; iPhone needs an approved reason
- Required Reason: disk space. Can check your free storage on iPhone only with a stated reason, and freely on Android
- Required Reason: active keyboards. Can list your keyboards on iPhone only for approved reasons; Android lists them freely
- Required Reason: UserDefaults. Can keep its own saved settings on iPhone, but must give Apple a reason
Sources
- Apple: Describing use of required reason API
- Apple: Privacy manifest files
- Apple: App Review Guidelines
How well checked: Checked against real behavior.