@sumsub/fisherman/README.md

The Sumsub Fisherman is a powerful tool that helps developers integrate fraud detection capabilities into their applications. With Fisherman, you can easily identify and prevent fraudulent activities within your system, providing a safer and more secure e

# @sumsub/fisherman

`@sumsub/fisherman` collects high-entropy signals from the browser to uniquely identify devices and user behavior. Use it to detect bots, anonymous environments, incognito mode, device farms, and other suspicious activity.
Note: This library is part of the broader Sumsub platform. It is not a standalone package. To use it, you need an active Sumsub account with Device Intelligence enabled and valid API credentials.

## ✨Features
* 🧠Detect high-risk devices – identify anonymous environments, virtual machines, bots, and device spoofing
* 🔁Spot risky patterns – flag reused devices, automation tools, unfamiliar devices, and incognito/private mode usage
* 🤖Prevent fraud early – catch bots, account takeovers, and multi-accounting before they cause damage
* 🧪Simulation mode – test your flows by simulating specific risk labels (e.g. `incognito`, `virtualMachine`) 📖[View risk label docs](https://docs.sumsub.com/docs/device-intelligence#what-risk-labels-device-intelligence-can-detect). You can also provide a test `visitorId` to emulate either a known or a new device.
* ⚙️TypeScript support – fully typed API for safer integration and a better developer experience

## 📦Installation

```bash
npm i @sumsub/fisherman --save
```

## 📚Documentation

[Sumsub's Device Intelligence](https://docs.sumsub.com/docs/device-intelligence)

[Get started with Device Intelligence](https://docs.sumsub.com/reference/get-started-with-device-intelligence)