This documentation is being shared in advance of upcoming age verification bills in applicable US states going into effect on January 1, 2026 in Texas. The Play Age Signals API (beta) will return live responses for applicable users and the Age signals page will be available in Play Console after this date.

AgeSignalsErrorCode

Kotlin |Java

public annotation AgeSignalsErrorCode

Error codes for Play Age Signals API.

Summary

Constants
`static final int`	`API_NOT_AVAILABLE = -1` The Play Age Signals API is not available.
`static final int`	`APP_NOT_OWNED = -9` The app was not installed by Google Play.
`static final int`	`CANNOT_BIND_TO_SERVICE = -5` Binding to the service in the Play Store has failed.
`static final int`	`CLIENT_TRANSIENT_ERROR = -8` There was a transient error in the client device.
`static final int`	`INTERNAL_ERROR = -100` Unknown internal error.
`static final int`	`NETWORK_ERROR = -3` No available network is found.
`static final int`	`NO_ERROR = 0`
`static final int`	`PLAY_SERVICES_NOT_FOUND = -4` Play Services is not available or its version is too old.
`static final int`	`PLAY_SERVICES_VERSION_OUTDATED = -7` Play Services needs to be updated.
`static final int`	`PLAY_STORE_NOT_FOUND = -2` No Play Store app is found on the device.
`static final int`	`PLAY_STORE_VERSION_OUTDATED = -6` The Play Store app needs to be updated.

Constants

API_NOT_AVAILABLE

public static final int API_NOT_AVAILABLE = -1

The Play Age Signals API is not available. The Play Store app version installed on the device might be old.

Possible resolution

Ask the user to update Play Store.

APP_NOT_OWNED

public static final int APP_NOT_OWNED = -9

The app was not installed by Google Play. Ask the user to get your app from Google Play.

CANNOT_BIND_TO_SERVICE

public static final int CANNOT_BIND_TO_SERVICE = -5

Binding to the service in the Play Store has failed. This can be due to having an old Play Store version installed on the device or device memory is overloaded. Ask the user to update the Play Store app. Retry with an exponential backoff.

CLIENT_TRANSIENT_ERROR

public static final int CLIENT_TRANSIENT_ERROR = -8

There was a transient error in the client device. Implement a retry strategy with a maximum number of attempts as an exit condition. If the issue still doesn't resolve, ask the user to try again later.

INTERNAL_ERROR

public static final int INTERNAL_ERROR = -100

Unknown internal error. Implement a retry strategy with a maximum number of attempts as an exit condition. If the issue still doesn't resolve, ask the user to try again later. If it fails consistently, contact Google Play Developer support, include Play Age Signals API in the subject, and include as much technical detail as possible (such as a bug report).

NETWORK_ERROR

public static final int NETWORK_ERROR = -3

No available network is found. Ask the user to check for a connection.

NO_ERROR

public static final int NO_ERROR = 0

PLAY_SERVICES_NOT_FOUND

public static final int PLAY_SERVICES_NOT_FOUND = -4

Play Services is not available or its version is too old. Ask the user to install, update, or enable Play Services.

PLAY_SERVICES_VERSION_OUTDATED

public static final int PLAY_SERVICES_VERSION_OUTDATED = -7

Play Services needs to be updated. Ask the user to update Play Services.

PLAY_STORE_NOT_FOUND

public static final int PLAY_STORE_NOT_FOUND = -2

No Play Store app is found on the device. Ask the user to install or enable the Play Store.

PLAY_STORE_VERSION_OUTDATED

public static final int PLAY_STORE_VERSION_OUTDATED = -6

The Play Store app needs to be updated. Ask the user to update the Play Store app.