> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fingerprintiq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /v1/demo/visits/:visitorId

Retrieve visit history for a visitor.

## Endpoint

```
GET https://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

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

### Headers

Your server-side secret API key.

```bash
curl https://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**

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

  **Visit object fields**

**visits[].id**

Unique UUID for this specific visit record.

    **visits[].timestamp**

Unix timestamp (milliseconds) when this visit occurred.

    **visits[].country**

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

    **visits[].city**

City name based on IP geolocation.

    **visits[].region**

Region or state name.

    **visits[].asn**

Autonomous System Number of the visitor's IP address.

    **visits[].asnOrg**

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

    **visits[].asnCategory**

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

    **visits[].botProbability**

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

    **visits[].confidence**

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

    **visits[].riskFactors**

Risk indicators active during this visit.

    **visits[].signals**

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

**totalVisits**

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

**firstSeenAt**

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.