Sessions

Get a visitor's session activity

GET/api/websites/{websiteId}/sessions/{sessionId}/activity

Returns activity for the specified session and sessions linked by visitor identity, using the requested date range and optional distinct ID.

Headers

Name	Type	Description
Authorizationrequired	string	Authentication credentials, e.g. `Bearer <token>`.

Path parameters

Name	Type	Description
websiteIdrequired	string	ID of the website.
sessionIdrequired	string	ID of the visitor session.

Query parameters

Name	Type	Description
startAtrequired	integer	Start of the date range as a Unix timestamp in milliseconds.
endAtrequired	integer	End of the date range as a Unix timestamp in milliseconds.
distinctId	string	Custom identifier assigned to the visitor.

Responses

200The operation completed successfully.

Name	Type	Description
createdAtrequired	string	Date and time the record was created.
eventIdrequired	string	ID of the event.
eventNamerequired	string	Name of the custom event.
eventTyperequired	number	Event type: 1 for a pageview or 2 for a custom event.
hasDatarequired	boolean
hostnamerequired	string	Hostname on which the activity occurred.
referrerDomainrequired	string	Domain of the referring page.
urlPathrequired	string	Path portion of the page URL.
urlQueryrequired	string	Query string portion of the page URL.
visitIdrequired	string	ID of the visit.

200 example

[
  {
    "createdAt": "string",
    "eventId": "string",
    "eventName": "string",
    "eventType": 0,
    "hasData": true,
    "hostname": "string",
    "referrerDomain": "string",
    "urlPath": "string",
    "urlQuery": "string",
    "visitId": "string"
  }
]

400Bad request.

Name	Type	Description
errorrequired	object	Error details returned when the operation fails.

400 example

{
  "error": {
    "code": "bad-request",
    "message": "Bad request.",
    "status": 400
  }
}

401Unauthorized.

Name	Type	Description
errorrequired	object	Error details returned when the operation fails.

401 example

{
  "error": {
    "code": "unauthorized",
    "message": "Unauthorized.",
    "status": 401
  }
}

Code samples

cURL

curl -X GET 'https://api.example.com/api/websites/{websiteId}/sessions/{sessionId}/activity?startAt=0&endAt=0' \
  -H 'Authorization: Bearer <token>'

PreviousGet traffic by weekday and hour NextGet a session's custom properties