Visitor detail with recent activity window

Authorizations

SessionCookie

Parameters

Path Parameters

projectId

required

string

visitorId

required

string

Query Parameters

days

integer

default: 90 >= 1 <= 365

Lookback window in days.

Responses

200

Visitor detail (dynamic shape). Some keys are dynamic — Route returns the repository record unchanged (c.json(payload)); return type is the declared DashboardVisitorDetailRecord. timeline is a heterogeneous array discriminated by type: “event” | “visit” | “conversion”, sorted ascending by ts (string compare of the ISO timestamps). Event timeline items have a SYNTHETIC id: ${occurredAt}:${eventName}:${visitorId}. data.properties on event items is arbitrary user-supplied JSON (parsed from propertiesJson) -> genuinely dynamic, kept permissive; null when absent/invalid JSON. firstVisit is derived from the first visit row, else the first event row, else null; browser/os fields come from best-effort user-agent parsing and are null when no UA present. firstVisit.deviceType falls back to “UNKNOWN” on the event-derived branch. stats.conversionCount counts only status === “SUCCESS” (differs from list endpoint semantics). NOTE: firstVisit.ip returns the raw stored IP address unmasked (PII, not a credential).

application/json

object

visitorId

required

string

userId

required

string

nullable

firstSeenAt

required

ISO-8601 UTC timestamp.

string

nullable

identifiedAt

required

ISO-8601 UTC timestamp.

string

nullable

firstVisit

required

object

required

string

nullable

userAgent

required

string

nullable

deviceType

required

DESKTOP | MOBILE | TABLET | UNKNOWN (stored value; not re-validated here).

string

referrer

required

string

nullable

utmSource

required

string

nullable

country

required

string

nullable

browser

required

string

nullable

browserVersion

required

string

nullable

required

string

nullable

osVersion

required

string

nullable

createdAt

required

ISO-8601 UTC timestamp.

string

stats

required

object

eventCount

required

integer

visitCount

required

integer

conversionCount

required

Count of SUCCESS conversions only.

integer

timeline

required

Array

One of:

TimelineEvent

object

type

required

string

Allowed values: event

required

ISO-8601 UTC timestamp (occurredAt).

string

data

required

object

required

Synthetic composite id “::”.

string

eventName

required

string

properties

required

Arbitrary caller-supplied event properties (dynamic; parsed JSON object).

object

key

additional properties

any

utmSource

required

string

nullable

utmMedium

required

string

nullable

utmCampaign

required

string

nullable

serverTimestamp

required

ISO-8601 UTC timestamp.

string

shortLink

required

object

required

string

name

required

string

nullable

shortCode

required

string

adPlatformConfig

required

object

required

string

name

required

string

platform

required

string

TimelineConversion

object

type

required

string

Allowed values: conversion

required

ISO-8601 UTC timestamp.

string

data

required

object

required

string

eventType

required

string

platform

required

string

platformEventType

required

string

nullable

status

required

string

Allowed values: PENDING SUCCESS FAILED DEAD_LETTER

errorMessage

required

string

nullable

createdAt

required

ISO-8601 UTC timestamp.

string

adPlatformConfig

required

Note - no platform field here (unlike the event variant).

object

required

string

name

required

string

GET

/api/projects/{projectId}/visitors/{visitorId}

1
curl --request GET \
2
  --url 'https://retidal.com/api/projects/%3Cstring%3E/visitors/%3Cstring%3E?days=90' \
3
  --cookie trackly_session=%3CYOUR_API_KEY%3E

1
const url = 'https://retidal.com/api/projects/%3Cstring%3E/visitors/%3Cstring%3E?days=90';
2
const options = {method: 'GET', headers: {cookie: 'trackly_session=%3CYOUR_API_KEY%3E'}};
3

4
try {
5
  const response = await fetch(url, options);
6
  const data = await response.json();
7
  console.log(data);
8
} catch (error) {
9
  console.error(error);
10
}

1
import requests
2

3
url = "https://retidal.com/api/projects/%3Cstring%3E/visitors/%3Cstring%3E"
4

5
querystring = {"days":"90"}
6

7
headers = {"cookie": "trackly_session=%3CYOUR_API_KEY%3E"}
8

9
response = requests.get(url, headers=headers, params=querystring)
10

11
print(response.json())

1
import httpx
2

3
url = "https://retidal.com/api/projects/%3Cstring%3E/visitors/%3Cstring%3E"
4

5
params = [("days", "90")]
6

7
cookies = {"trackly_session": "<YOUR_API_KEY>"}
8

9
response = httpx.get(url, params=params, cookies=cookies)
10

11
print(response.json())

1
package main
2

3
import (
4
  "fmt"
5
  "net/http"
6
  "io"
7
)
8

9
func main() {
10

11
  url := "https://retidal.com/api/projects/%3Cstring%3E/visitors/%3Cstring%3E?days=90"
12

13
  req, _ := http.NewRequest("GET", url, nil)
14

15
  req.Header.Add("cookie", "trackly_session=%3CYOUR_API_KEY%3E")
16

17
  res, _ := http.DefaultClient.Do(req)
18

19
  defer res.Body.Close()
20
  body, _ := io.ReadAll(res.Body)
21

22
  fmt.Println(res)
23
  fmt.Println(string(body))
24

25
}

200Visitor detail (dynamic shape). Some keys are dynamic — Route returns the repository record unchanged (c.json(payload)); return type is the declared DashboardVisitorDetailRecord. timeline is a heterogeneous array discriminated by type : “event” | “visit” | “conversion”, sorted ascending by ts (string compare of the ISO timestamps). Event timeline items have a SYNTHETIC id: ${occurredAt}:${eventName}:${visitorId} . data.properties on event items is arbitrary user-supplied JSON (parsed from propertiesJson) -> genuinely dynamic, kept permissive; null when absent/invalid JSON. firstVisit is derived from the first visit row, else the first event row, else null; browser/os fields come from best-effort user-agent parsing and are null when no UA present. firstVisit.deviceType falls back to “UNKNOWN” on the event-derived branch. stats.conversionCount counts only status === “SUCCESS” (differs from list endpoint semantics). NOTE: firstVisit.ip returns the raw stored IP address unmasked (PII, not a credential).

1
{
2
  "timeline": [
3
    {
4
      "type": "event"
5
    }
6
  ]
7
}