GET /v1/demo/visits/:visitorId

Retrieve visit history for a visitor.

Endpoint

text
GET https://api.fingerprintiq.com/v1/demo/visits/:visitorId

This endpoint is server-side only. Always call it from your backend using a secret API key — never from the browser.

Request

Path Parameters

visitorId string required

The visitor ID returned by the /v1/identify endpoint. Format: iq_<ulid> (e.g., iq_01hns3k6tez83695a6t714s6n1).

Headers

X-API-Key string required

Your server-side secret API key.

bash
curl https://api.fingerprintiq.com/v1/demo/visits/iq_01hns3k6tez83695a6t714s6n1 \
  -H "X-API-Key: fiq_live_your_secret_key"

Response

json
{
  "visits": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "timestamp": 1712000003000,
      "country": "US",
      "city": "New York City",
      "region": "New York",
      "asn": 7922,
      "asnOrg": "Comcast Cable Communications, Inc",
      "asnCategory": "RESIDENTIAL_ISP",
      "botProbability": 0.05,
      "confidence": 1.0,
      "riskFactors": [],
      "signals": { "client": { "..." }, "server": { "..." } }
    }
  ],
  "totalVisits": 3,
  "firstSeenAt": 1712000000000
}

Response Fields

visits array

The 20 most recent visits for this visitor, ordered newest first.

Visit object fields

visits[].id string

Unique UUID for this specific visit record.

visits[].timestamp number

Unix timestamp (milliseconds) when this visit occurred.

visits[].country string

ISO 3166-1 alpha-2 country code (e.g., US, GB, DE).

visits[].city string

City name based on IP geolocation.

visits[].region string

Region or state name.

visits[].asn number

Autonomous System Number of the visitor's IP address.

visits[].asnOrg string

Organization name for the ASN (e.g., "Comcast Cable Communications, Inc").

visits[].asnCategory string

ASN category: RESIDENTIAL_ISP, MOBILE_CARRIER, DATACENTER, VPN_COMMERCIAL, TOR_EXIT, EDUCATION, GOVERNMENT, or CDN.

visits[].botProbability number

Bot likelihood score (0.0–1.0) for this visit.

visits[].confidence number

Signal confidence score (0.0–1.0) for this visit.

visits[].riskFactors string[]

Risk indicators active during this visit.

visits[].signals object

Full signal snapshot for this visit, including all client and server signals.

totalVisits number

Total number of visits ever recorded for this visitor (not just the 20 returned in visits).

firstSeenAt number

Unix timestamp (milliseconds) of the very first visit from this device.

Use totalVisits and firstSeenAt to assess trust. A visitor seen 50 times over 3 months is very different from one seen 3 times in the last 10 minutes.

Was this page helpful?

Previous POST /v1/identify

Next Webhooks