Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazon Appstore
Ring
AWS
Documentation
Support
Contact Us
My Cases
Devices
Build
Test
Publish
Connect
Documentation
Skip to main content
Certain states in the US, such as Texas, Utah, and Louisiana, have passed laws that require app stores to verify users’ ages, obtain parental consent for users under 18 years old, and share users’ age information with developers. These laws also require developers to comply with certain obligations to distribute their apps through the Amazon Appstore on Fire tablets in these states, including obtaining age-related data, and notifying app stores of significant app changes. To support the developers, Amazon Appstore is providing you with an API to help you comply with these laws. This page explains how to do the following:
  • 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.
Use of the GetUserAgeData API is subject to the Appstore Developer Services Agreement. You are responsible for making sure your app is compliant with all applicable regulations and Amazon Appstore policies. If an eligible user account is identified as being in an applicable US state, Appstore will require age verification in accordance with that specific state’s effective legal date.

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.
Based on these signals, it’s your responsibility to provide age-appropriate experiences within your app.

Usage

To access Amazon’s GetUserAgeData API, use Android’s ContentProvider API. The basic usage to query the API is as follows.
For more detailed examples, see Integrate and Test the GetUserAgeData API.

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)
Example response for a non-adult user (under 18 years old)
The GetUserAgeData API response includes the following fields and values.
FieldDescription
responseStatusThe response status of the GetUserAgeData API. Valid values:
  • SUCCESS – The API successfully returned the user information.
  • APP_NOT_OWNED – The app that called the GetUserAgeData API wasn’t installed from Amazon Appstore.
  • INTERNAL_TRANSIENT_ERROR – An error occurred. Indicates the error is transient and might resolve after retrying. Consider setting a maximum of two retries.
  • INTERNAL_ERROR – An error occurred. Indicates retries are unlikely to resolve the error.
  • FEATURE_NOT_SUPPORTED – The GetUserAgeData API is not enabled on this device. This can occur on legacy devices that do not receive new feature support.
If the responseStatus field has any value other than SUCCESS, all other fields in the response will be null or empty.
userStatusThe age verification and consent status of the user. Valid values:
  • VERIFIED – For a user who is 18+ years old in a region where the age verification law is applicable, indicates the user’s age is verified.
  • SUPERVISED – For a user who is under 18 years old in a region where the age verification law is applicable, indicates a parent or guardian provided consent.
  • UNKNOWN – In jurisdictions or regions where age verification law is applicable, the user’s age and consent status is not verified. The age range of the user is unconfirmed.
  • CONSENT_NOT_GRANTED – In a region where the age verification law is applicable, indicates one of the following:
    • The parent or guardian revoked their consent.
    • There is a significant change in effect, and the re-consent of the parent or guardian is pending.
    • There is a significant change in effect, and the parent or guardian denied the re-consent request.
  • Empty string "" – For a user in a region where the age verification law isn’t applicable, the value is empty. Also, if the app is a part of the Amazon Kids+ subscription, the value is empty.
ageLowerThe 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.
ageUpperThe 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.
userIdThe anonymous unique app-level identifier of the signed-in profile.
Null if userStatus is VERIFIED, UNKNOWN, or empty.
mostRecentApprovalDateThe 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.
For details on how to set up your code and test the GetUserAgeData API, see Integrate and Test the GetUserAgeData API.

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. 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 anonymous userId that the GetUserAgeData API returns in its response. For instructions on how to download the report, see Parental Consent Revocation Report.

User age verification FAQ

The following are frequently asked questions (FAQ) about user age verification.
Last modified on September 25, 2026