Different accounts. One device.

1. 01 Tag the request

   Identify at signup, login or checkout, with your own reference as the tag. It comes back on the event and the webhooks.

   identify({ tag: "signup:acct_4821" })
2. 02 Store the visitor ID

   Save the visitor ID your server verified next to the account or order it belongs to.

3. 03 Look up the device

   Query your own records for other accounts with the same visitor ID, and read that device’s recent events from the API.

   GET /api/v1/events?visitor=X9pL2mRc7KvT4bQw8NdF

import { load } from '@fingerly/node'

const fingerly = load({ secretKey: process.env.FINGERLY_SECRET_KEY })

// Everything this device did in the last week
const { rows } = await fingerly.events.list({
  visitor: 'X9pL2mRc7KvT4bQw8NdF',
  from: new Date(Date.now() - 7 * 864e5).toISOString(),
  limit: 200,
})

const tags = new Set(rows.map((event) => event.tag).filter(Boolean))
// tags now holds every account reference this device was identified with

The console’s Events view filters by visitor ID too, for investigations by hand.