Skip to Content
Platform.Ontology

Required reason APIs

Apple lists APIs that can be used to fingerprint a device and requires the app to state an approved reason.

Works without askingOther apps on the phoneStore transparencyAndroid and iPhoneWhile you use it

In one line

Can't use fingerprint prone phone details on iPhone without an approved reason

Apple lists APIs that can be used to fingerprint a device and requires the app to state an approved reason.

Five categories: file timestamp, system boot time, disk space, active keyboards, and UserDefaults. An unapproved reason is a rejection, so fingerprinting uses are fenced in.

What it can and can't do

What the user does: Nothing. Apple checks the reasons when the developer submits the app

It can

  • Use file times, boot time, free disk space, active keyboards and saved settings for approved reasons
  • Include these reasons for third party tools as well
  • Show the reasons in a file Apple checks

It cannot

  • Use these details to fingerprint your phone, even if you said yes
  • Use them for any reason not on Apple's list, or the app is rejected
  • Skip the reasons after 1 May 2024 and still get through review
  • Apply on Android; Play bans some IDs in other ways

How it differs between platforms: This is Apple only, in force since 1 May 2024. Android has no required reason list.

On Android and iPhone

AndroidiPhone
StatusNot supportedSupported
First versionNot availableiOS 17.0
Permission or entitlementNot listedNot listed
Protection levelnonenone
How access is grantednot-exposednone
What the user seesNot listedNot listed
How long it lastsNot listedNot listed
How to take it backNot listedNot listed
Store policyNone listedApproved reason codes per API category (for example CA92.1 for UserDefaults app own data)
APINot listedNSPrivacyAccessedAPITypes in manifest
NotesAndroid has no required reason list; Play bans some identifiers instead.Enforced 1 May 2024. Covers third party SDK use too. Apple has said it targets fingerprint inputs.

Data you get

What comes back: Approved reason codes
Shape: list
How often: static

FieldTypeUnitRangePrecision
NSPrivacyAccessedAPITypestringNoneNot listedNot listed
NSPrivacyAccessedAPITypeReasonslistNoneNot listedNot listed

Technical limits

  • Reasons must match real use
  • No cross-app tracking use allowed

The story

What it is

Apple's list of device clues that need a stated reason because they can fingerprint a phone.

For you

You do not see it. It means apps cannot quietly check things like how long your phone has been on and use that to follow you around.

For makers

The five groups are file timestamps, boot time, disk space, active keyboards and UserDefaults. Makers must pick an allowed reason, or Apple rejects the upload, which kills most casual fingerprinting.

Where you see it

TypeExampleApps
gamesA game reads free disk space to decide whether to download high resolution art, and states that reason.Genshin Impact
adsAn ad SDK that used boot time as part of an ID must stop or state a legitimate reason.AppLovin, Unity Ads
analyticsAn analytics SDK reads the system uptime to measure app launch speed only.Firebase
securityA fraud tool lists the exact use of each API so Apple can check it against abuse.None named
socialA photo app reads file creation dates to sort a gallery.Instagram
developerA developer finds an old library using UserDefaults for tracking and swaps it out.None named

Risks

  • Reasons are self reported
  • Workarounds keep appearing

Android and iPhone in short

  • Android: Android has no direct counterpart. Google limits fingerprinting through policy and API changes.
  • iPhone: Enforced when the app is uploaded to App Store Connect.

What the platform says

Good uses and abuse

Legitimate uses

  • Limits covert fingerprinting

Known abuse

  • Reason shopping

Scores

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

History

  • 2024-05, iPhone App Store: Enforcement on 1 May 2024

Same idea on the web

Sources

How well checked: Based on official documentation.

On this page