Skip to main content
GET
/
api
/
v1
/
radar
/
people
/
details
Person details
curl --request GET \
  --url https://taap.it/api/v1/radar/people/details \
  --header 'Authorization: <authorization>'
{
  "error": "Visitor not found"
}
Returns one person (visitor) with their profile, the list of sessions in the range, and a daily activity heatmap. Responses are always freshly computed (not cached). Request:
cURL
curl -X GET 'https://taap.it/api/v1/radar/people/details?visitorId=v_8a1c2d&start=2026-01-01T00:00:00Z&end=2026-01-31T23:59:59Z' \
  -H 'Authorization: Bearer taapit_your_api_key_here'
Response: 
{
  "data": {
    "visitor": {
      "visitorId": "v_8a1c2d",
      "name": "Quiet Fox",
      "email": "jane@example.com",
      "status": "identified",
      "countryCode": "FR",
      "countryName": "France",
      "source": "google",
      "browser": "Chrome",
      "device": "desktop",
      "revenue": 120.0,
      "sessions": 4,
      "firstSeen": "2026-01-03T09:12:00.000Z",
      "lastSeen": "2026-01-28T17:42:00.000Z"
    },
    "sessions": [
      {
        "sessionId": "s_5f2a",
        "startTime": "2026-01-28T17:10:00.000Z",
        "endTime": "2026-01-28T17:42:00.000Z",
        "durationSeconds": 1920,
        "referrer": "google",
        "device": "desktop",
        "browser": "Chrome",
        "os": "macOS"
      }
    ],
    "heatmap": [
      { "date": "2026-01-28", "events": 12 }
    ]
  }
}

​
Authorization

​
Authorization
string
required
Bearer token with your Radar API key. Format: Bearer taapit_...

​
Query Parameters

​
visitorId
string
required
The visitor identifier returned by the People endpoint.
​
start
string
required
Start of the range, ISO 8601 (UTC).
​
end
string
required
End of the range, ISO 8601 (UTC).

​
Response Fields

​
data.visitor
object
The person’s profile (same shape as a row in the People endpoint).
​
data.sessions
array
Sessions within the range.
​
data.heatmap
array
Daily activity, each entry with date (YYYY-MM-DD) and events count.
{
  "error": "Visitor not found"
}