GetUserViewLog

# GetUserViewLog API

Returns the complete read/view log history for a specified user, showing all documents accessed by that user. This API retrieves entries from both the current view log (VIEWLOG table) and historical read logs (HISTORY_READ table).

Endpoint¶

/srv.asmx/GetUserViewLog

Methods¶

• GET /srv.asmx/GetUserViewLog?authenticationTicket=...&userName=...
• POST /srv.asmx/GetUserViewLog (form data)
• SOAP Action: http://tempuri.org/GetUserViewLog

Parameters¶

Response¶

Success Response¶

Returns a <response> root element containing a <viewlogs> element, which holds zero or more <viewlog> child elements. Each element represents a document view/read event.

<response success="true" error="">
  <viewlogs>
    <viewlog DocumentId="1523" 
             UserId="7" 
             UserFullname="John Smith" 
             DocumentName="Q1-Report.pdf" 
             VersionNumber="2.0.0" 
             ViewDate="2024-06-15T10:30:00.000Z" 
             DomainName="Finance" 
             Path="/Finance/Reports" />
    <viewlog DocumentId="1489" 
             UserId="7" 
             UserFullname="John Smith" 
             DocumentName="Budget-2024.xlsx" 
             VersionNumber="1.0.0" 
             ViewDate="2024-06-14T14:20:00.000Z" 
             DomainName="Finance" 
             Path="/Finance/Planning" />
  </viewlogs>
</response>

Viewlog Element Attributes¶

Error Response¶

<response success="false" error="User not found." />

Required Permissions¶

The calling user must be authenticated. Any authenticated user can retrieve view logs for any user — there is no permission check restricting this to administrators or the user themselves.

Example¶

GET Request¶

GET /srv.asmx/GetUserViewLog
  ?authenticationTicket=3f2504e0-4f89-11d3-9a0c-0305e82c3301
  &userName=jsmith
HTTP/1.1

POST Request¶

POST /srv.asmx/GetUserViewLog HTTP/1.1
Content-Type: application/x-www-form-urlencoded

authenticationTicket=3f2504e0-4f89-11d3-9a0c-0305e82c3301
&userName=jsmith

SOAP Request¶

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:tns="http://tempuri.org/">
  <soap:Body>
    <tns:GetUserViewLog>
      <tns:authenticationTicket>3f2504e0-4f89-11d3-9a0c-0305e82c3301</tns:authenticationTicket>
      <tns:userName>jsmith</tns:userName>
    </tns:GetUserViewLog>
  </soap:Body>
</soap:Envelope>

Notes¶

• This API retrieves all view/read logs for the specified user without date filtering. To filter by date range, use GetUserViewLog1.
• The response combines entries from both the active view log (VIEWLOG table) and the historical read log (HISTORY_READ table).
• Duplicate entries (same user, document, version, and timestamp) are automatically removed from the combined result set.
• Results are sorted by ViewDate in ascending order (oldest first).
• All date fields use UTC ISO 8601 format (yyyy-MM-ddTHH:mm:ss.fffZ). An empty string means the date is not recorded.
• The VersionNumber attribute shows the multi-part version format (major.minor.revision) rather than the internal integer format.
• If the specified user has never accessed any documents, an empty <viewlogs/> element is returned (not an error).
• The API does not verify that the calling user has permission to view the audit logs — any authenticated user can query any other user's view history.

Related APIs¶

• GetUserViewLog1 - Get user view log history filtered by date range
• GetDocumentViewLog - Get the view log for a specific document (all users who accessed it)
• GetDocumentReadLogHistory - Get detailed read log history for a specific document and user

Error Codes¶

For detailed documentation visit: https://support.inforouter.com/api-docs/GetUserViewLog