- Use Amazon’s GetUserAgeData API (“API”) to obtain age-related signals for users.
- Notify Amazon Appstore of significant changes to your app that require renewed parental consent.
- Be notified about revoked parental consent for your app.
GetUserAgeData API
Your app can retrieve the user’s verification status and age signal by querying Amazon’s GetUserAgeData API. The API provides the following information for users in the applicable jurisdictions upon app downloads, app purchases, and transactions using Amazon’s In-App Purchasing (IAP) system. For apps that use payment methods outside of Amazon IAP APIs, you must implement your own mechanisms to obtain parental consent for any in-app purchase and ensure compliance with all applicable age verification laws.-
Age signal based on one of the following age ranges:
- 0-12 years old
- 13-15 years old
- 16-17 years old
- 18+ years old
- For users under 18, the parental consent status for the current version of the app.
Usage
To access Amazon’s GetUserAgeData API, use Android’s ContentProvider API. The basic usage to query the API is as follows.Response structure
The GetUserAgeData API provides responses in JSON format, as shown in the following examples. For details on each field, review the table in this section. Example response for an adult user (18+ years old)| Field | Description |
|---|---|
responseStatus | The response status of the GetUserAgeData API. Valid values:
responseStatus field has any value other than SUCCESS, all other fields in the response will be null or empty. |
userStatus | The age verification and consent status of the user. Valid values:
|
ageLower | The lower age limit included in the age range that the user belongs to. Valid values are 0, 13, 16, and 18.Null if userStatus is UNKNOWN, or empty. |
ageUpper | The upper age limit included in the age range that the user belongs to. Valid values are 12, 15, 17, and null.Null for a user who is 18+ years old. Null if userStatus is VERIFIED, UNKNOWN, or empty. |
userId | The anonymous unique app-level identifier of the signed-in profile. Null if userStatus is VERIFIED, UNKNOWN, or empty. |
mostRecentApprovalDate | The effective from date of the most recent significant change that was approved. Uses ISO 8601 format. Null for a user who is 18+ years old, where consent isn’t applicable. Null if userStatus is VERIFIED, UNKNOWN, or empty. |
Notify Appstore of a significant change
These age verification laws might require you to inform Appstore about certain app changes, referred to as significant changes. You are responsible for determining when you must notify Appstore of such a change. You can report a significant change when updating your app in the Developer Console. For details, see Report a significant change.Consent revocation report
A parent or guardian can revoke consent for your app for a user who is under 18 years old. If this occurs, that user will no longer be able to access that app. Appstore will provide data on the revocation in a report that you can download from the reporting section of the Developer Console. The report lists revoked consents using the same anonymoususerId that the GetUserAgeData API returns in its response. For instructions on how to download the report, see Parental Consent Revocation Report.

