Jump to: navigation, search

Query visits by identity

Description

This method retrieves the visits for a given identity.

Request

Method GET
URL /identities/${identityId}/visits
Parameters
Name Value Mandatory Description
${identityId} string yes Identity identifier.
age integer no Visits' maximum age in seconds. Older visits will not be returned.
globalVisitID string no Filters the visit results based on the given global Visit ID.
userAgent string no Returns the visits matching the UserAgent field.
include_sessions
  • true
  • false
no If true, the returned visits contain the reference list of sessions.
include_sessions_detail
  • true (if include_sessions=true)
  • false
no If true, the returned visits contain the associated sessions. You can only use this parameter if include_sessions is set to true.
include_pages
  • true
  • false
no If true, the returned visits contain the reference list of the associated pages.
include_pages_detail
  • true(if include_pages=true)
  • false
no If true, the returned visits contain the associated pages. You can only use this parameter if include_pages is set to true.
include_events
  • true
  • false
no If true, the returned visits contain the reference list of associated events.
include_events_detail
  • true (if include_events=true)
  • false
no If true,  the returned visits contain the associated events.
You can only use this parameter if include_events is set to true.

<references />

Response

The History REST API answers with HTTP codes for every request. The following table shows the correct response for a successful request. See HTTP Response Codes and Errors for further details on the possible codes that this request can return.

HTTP code 200
HTTP Title OK
Body  JSON Array of Visit resources.
This page was last edited on July 11, 2014, at 19:53.
Comments or questions about this documentation? Contact us for support!