Node.js Server API SDK

Using FingerprintJS Pro Server API Node.js SDK

This open-source library improves the development experience for projects using Node.js. It simplifies communication with the Fingerprint Pro Server API which is used for getting information about visitors and individual events in a server environment. Server API can be used for data exports, decision-making, and data analysis scenarios.

Example Use

Include the secret API key and region in the constructor and use the client instance for API requests.

import { FingerprintJsServerApiClient, Region } from '@fingerprintjs/fingerprintjs-pro-server-api';

// Init client with the given region and the api key
const client = new FingerprintJsServerApiClient({region: Region.Global, apiKey: "<api_key>"});

// Get visitor history
client.getVisitorHistory("<visitorId>").then(visitorHistory => {

Additionally, you can also apply filters for the getVisitorHistory function.

const filters = {
    request_id: "<request_id>",
    linked_id: "<linked_id>",
    limit: 5,
    before: "<timeStamp>"

client.getVisitorHistory("<visitorId>", filters).then(visitorHistory => {

If you use TypeScript, you can also use built-in types for webhooks.

import { VisitWebhook } from '@fingerprintjs/fingerprintjs-pro-server-api';

const visit = visitWebhookBody as unknown as VisitWebhook;


You can find the full documentation in the official GitHub repository.