1.2 (May 26, 2021)
Oct 20, 2020
Mar 8, 2022
FingerprintJS (fingerprintjs)
Alexey Verkhovsky (Alexey-Verkhovsky)
Valenтin Vasiλьев (Valve)
Ye Myat Thu (yemyatthu1990)
Source code


FingerprintJS Android

Lightweight library for device identification and fingerprinting.

Fully written in Kotlin. 100% Crash-free.

Creates a device identifier from all available platform signals.

The identifier is fully stateless and will remain the same after reinstalling or clearing application data.

Table of Contents

  1. Quick start
  2. Usage
  3. Playground App

Quick start

1. Add repository

Add these lines to your build.gradle.

allprojects { 
  repositories {
  maven { url '' } 

2. Add dependency

Add these lines to build.gradle of a module.

This library depends on kotlin-stdlib.

If your application is written in Java, add kotlin-stdlib dependency first (it's lightweight and has excellent backward and forward compatibility).

dependencies {
  // Add this line only if you use this library with Java
  implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"

  implementation "com.github.fingerprintjs:fingerprint-android:1.2"

deviceId vs fingerprint

The library operates with two entities.

  1. deviceId - is a random and unique device identifier.

Can be used by developers to identify devices to deliver personalized content, detect suspicious activity, and perform fraud detection. Internally it will use Google Service Framework ID if it's available and ANDROID_ID, if GSF ID is not available. This identifier is stable, i.e. it will remain the same even after reinstalling your app. But it will be different after factory reset of the device.

  1. fingerprint is a digital device fingerprint. It works by combining all available device signals and attributes into a single identifier. There is a probability that two identical devices will have the same fingerprint.

Which one should I use?

deviceId is guaranteed to be random and should be your first choice for device identification. This identifier can be spoofed though and shouldn't be used in security-focused or fraud detection scenarios.

fingerprint is much harder to spoof and is a safer choice in security-focused use cases.

3. Get deviceIDs and fingerprints


// Initialization
 val fingerprinter = FingerprinterFactory
  .getInstance(applicationContext, Configuration(version = 3))

// Usage
fingerprinter.getFingerprint { fingerprintResult ->
  val fingerprint = fingerprintResult.fingerprint

fingerprinter.getDeviceId { result ->
  val deviceId = result.deviceId


// Initialization
Fingerprinter fingerprinter = FingerprinterFactory
    .getInstance(getApplicationContext(), new Configuration(3));

// Usage
fingerprinter.getFingerprint(new Function1<FingerprintResult, Unit>() {
        public Unit invoke(FingerprintResult fingerprintResult) {
         String fingerprint = fingerprintResult.getFingerprint();
             return null;
fingerprinter.getDeviceId(new Function1<DeviceIdResult, Unit>() {
            public Unit invoke(DeviceIdResult deviceIdResult) {
             String deviceId = deviceIdResult.getDeviceId();
                return null;

getFingerprint and getDeviceId methods execute on a separate thread. Keep this in mind when using results on the main thread.

Also the results are cached, so subsequent calls will be faster.


fingerprint is versioned incrementatlly; the version should be set explicitly to avoid unexpected fingerprint changes when updating the library.

The version is set while the initialization of the library with Configuration class.

val fingerprinter = FingerprinterFactory
  .getInstance(applicationContext, Configuration(version = 3))

See full Kotlin reference/Java reference.

Playground App

Try all the library features in the Playground App.

Android API support

fingerprint-android supports API versions from 21 (Android 5.0) and higher.


Feel free to ask questions and request features. Just create an issue with a clear explanation of what you'd like to have in the library. For code contributions, please see the contributing guideline.


Just tested on HUAWEI Y6p, with factory reset, we can retrieve the same result with StabilityLevel.STABLE setting.

Thank you

GitHub user


This library is MIT licensed. Copyright FingerprintJS, Inc. 2020-2022.