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. Use library version 0.0.2 or higher of the Play Age Signals API (beta) to receive live responses for applicable users starting on January 1, 2026. The Age signals page will also be available in Play Console after this date.

AgeSignalsErrorCode

Kotlin |Java

annotation AgeSignalsErrorCode

Error codes for Play Age Signals API.

Summary

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

Constants

API_NOT_AVAILABLE

const val API_NOT_AVAILABLE = -1: Int

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

const val APP_NOT_OWNED = -9: Int

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

CANNOT_BIND_TO_SERVICE

const val CANNOT_BIND_TO_SERVICE = -5: Int

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

const val CLIENT_TRANSIENT_ERROR = -8: Int

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

const val INTERNAL_ERROR = -100: Int

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

const val NETWORK_ERROR = -3: Int

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

NO_ERROR

const val NO_ERROR = 0: Int

PLAY_SERVICES_NOT_FOUND

const val PLAY_SERVICES_NOT_FOUND = -4: Int

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

const val PLAY_SERVICES_VERSION_OUTDATED = -7: Int

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

PLAY_STORE_NOT_FOUND

const val PLAY_STORE_NOT_FOUND = -2: Int

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

PLAY_STORE_VERSION_OUTDATED

const val PLAY_STORE_VERSION_OUTDATED = -6: Int

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