User Age Verification

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 in these states. 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.

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:

• 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.

Copy code Copied to clipboard.

Cursor cursor = getContentResolver().query(
    Uri.parse("content://amzn_appstore/getUserAgeData"),
    null, null, null, null, null);

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)

{
   "responseStatus": "SUCCESS",
   "userStatus": "VERIFIED",
   "ageLower": 18,                // Always 18 for a user 18+ years old
   "ageUpper": null,              // Always null for a user 18+ years old
   "userId": null,                // Not applicable for a user 18+ years old
   "mostRecentApprovalDate": null // Not applicable for a user 18+ years old
}

Example response for a non-adult user (under 18 years old)

{
   "responseStatus": "SUCCESS",
   "userStatus": "SUPERVISED",
   "ageLower": 0,
   "ageUpper": 12,
   "userId": "<uniqueId>",
   "mostRecentApprovalDate": "2026-01-01T12:00:00Z"
}

The GetUserAgeData API response includes the following fields and values.

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.

Notification of consent revocation

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 notify you of the revocation in a report that you can download from the reporting section of the Developer Console. The report lists all revoked consents using the same anonymous userId that the GetUserAgeData API returns in its response.

User age verification FAQ

The following are frequently asked questions (FAQ) about user age verification.

Q: When the age verification laws go into effect, will the current version of my app still be available on Amazon Appstore?

Yes, the current version of your app will be available on Appstore. However, it is your responsibility to make sure your app is compliant with all applicable laws.

Q: How do I report that my app has significant changes?

You can report significant changes to your app as part of the metadata update during the app submission flow in the Developer Console.

Note: If you update your app using the App Submission API, it is your responsibility to report any significant changes by submitting a metadata update through the Developer Console.

Q: How does Amazon ensure the accuracy of the information provided?

As the developer, you are responsible for making sure you provide accurate information and select the correct effective date when introducing a significant change to your app.

Q: Where can I get more information about the age verification act?

For more information, you can review the bills as follows:

• Texas - https://capitol.texas.gov/tlodocs/89R/billtext/html/SB02420I.htm
• Utah - https://le.utah.gov/Session/2025/bills/enrolled/SB0142.pdf
• Louisiana - https://www.legis.la.gov/legis/ViewDocument.aspx?d=1425304

Q: As a developer, can I access the history of my significant change declarations?

The Developer Console doesn't currently provide the history of significant change submissions.

Q: After I declare a significant change, what is the customer experience after the effective date?

For a Kids profile, the parent must provide their renewed consent for the child to be able to continue using the app. If the parent doesn't renew their consent, the child's access to the app is revoked. For an adult profile, there is no change.

Q: How do I know if a user is 18 or over?

To determine whether the user is 18 or over, use the GetUserAgeData API. In the response, userStatus will be VERIFIED, and ageLower will be 18.

Q: How do I know if a user is on a Kids profile?

To determine whether the user is under 18 years old, use the GetUserAgeData API. In the response, userStatus will be SUPERVISED, and ageLower and ageUpper will be non-null values.

Q: How can I restrict distribution of my app from Louisiana, Texas, Utah, or other states?

The Appstore doesn't support restricting app distribution at the state level.

Related topics

• Integrate and Test the GetUserAgeData API

Last updated: Nov 06, 2025