--- title: "userActivityQuery (Command)" slug: "oas-fullsdk-soapref-useractivityquery-command-3-28" updated: 2025-07-04T10:05:21Z published: 2025-07-07T15:34:14Z canonical: "docs.onespan.com/oas-fullsdk-soapref-useractivityquery-command-3-28" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.onespan.com/llms.txt > Use this file to discover all available pages before exploring further. # userActivityQuery (Command) The userActivityQuery command allows to query the recent authentication, signature validation, administration, and provisioning activity of a particular user. ## Parameters | Parameter name | Data type | Description | | --- | --- | --- | | sessionID | String | Required. The session identifier of the current administrative session. The logon command returns this identifier after a successful logon (see [logon (Command)](/sec/docs/oas-fullsdk-soapref-logon-command-3-28)). | | options | UserActivityQueryOptions | Optional. Options to determine what results should be returned. See [UserActivityQueryOptions (Data type)](/sec/docs/oas-fullsdk-soapref-useractivityquery-command-3-28#useractivityqueryoptions-data-type). | | user | UserActivityInput | Required. Specifies the user to query recent activities (see [UserActivityInput (Data type)](/sec/docs/oas-fullsdk-soapref-useractivityquery-command-3-28#useractivityinput-data-type)). | | Parameter name | Data type | Description | | --- | --- | --- | | errorStack | ErrorStack | Optional. The error stack, indicating that the command has not completed successfully. | | resultCodes | ResultCodes | Required. The result and status codes returned by the command. | | resultCount | Integer | Required. The number of items in userActivityList. | | userActivityList | UserActivityList | Optional. List containing the queried user activities (see [UserActivityList (Data type)](/sec/docs/oas-fullsdk-soapref-useractivityquery-command-3-28#useractivitylist-data-type)). | ### UserActivityInput (Data type) | Element name | Data type | Description | | --- | --- | --- | | userID | String | The ID of the user to query. | | domain | String | The domain of the user to query. | ### UserActivityQueryOptions (Data type) | Element name | Type | Description | | --- | --- | --- | | rowOffset | Unsigned Integer | Optional. Option to request OneSpan Authentication Server to return result records starting from the specified offset. Can only be used together with rowCount. Default value: 0 | | rowCount | Unsigned Integer | Optional. Option to request OneSpan Authentication Server to return the specified number of result records, beginning with the record specified by rowOffset. If set to 0, all result records are returned. Default value: 0 | | countOnly | Boolean | Optional. Flag to request OneSpan Authentication Server to return only the number of records in the result set, but not the result set itself. Default value: false | | filter | UserActivityFilterExpression | Optional. Filter configuration for the result set (see [UserActivityFilterExpression (Data type)](/sec/docs/oas-fullsdk-soapref-useractivityquery-command-3-28#useractivityfilterexpression-data-type)). | | sortOrder | UserActivitySortOrder | Optional. Determines the sort order of the result set. By default, the result set is not sorted (see [UserActivitySortOrder (Data type)](/sec/docs/oas-fullsdk-soapref-useractivityquery-command-3-28#useractivitysortorder-data-type)). | ### UserActivityFilterExpression (Data type) | Element name | Data type | Description | | --- | --- | --- | | field | UserActivityFilter | A filter expression definition for one particular attribute field. | | Attribute name | Data type | Description | | --- | --- | --- | | name | UserActivityFilterFieldEnum | The field attribute to use as key to filter the result set. Possible values: - clientType - policyID | | Element name | Data type | Description | | --- | --- | --- | | equals | String | Specifies the value to compare with UserActivityFilter.name. Cannot be used with isNotNull. | | isNotNull | EmptyType | Verifies that UserActivityFilter.name is not empty. Cannot be used with equals. | ### UserActivitySortOrder (Data type) | Element name | Data type | Description | | --- | --- | --- | | name | UserActivitySortOrderFieldEnum | Determines the field attribute to use as key to sort the result set. Possible values: - category - clientLocation - code - policyID - serialNumber - timestamp | | order | SortOrderEnum | Determines the sort order of the result set. Possible values: - ASC. Result set in ascending order. - DESC. Result set in descending order. | ### UserActivityList (Data type) | Element name | Returned? | Description | | --- | --- | --- | | AMID | Always | The audit message identifier. | | auditLocation | Always | The location of the component that audited the message. Typically an IP address. | | category | Always | The audit category. | | clientLocation | Optional | The location of the client component that triggered the audit message. Typically an IP address. | | clientType | Optional | The client component type. | | code | Always | The audit message code. | | description | Always | The description of the audit message. | | policyID | Optional | The policy related to the audit message. | | reason | Optional | A textual description why the message was audited. | | serialNumber | Optional | The serial number of the authenticator related to the audit message. | | source | Always | The string representation of the source of the audit message. | | timestamp | Always | The time when the audit message was recorded. | | type | Always | The type of the audit message. Possible values: - Error - Failure - Information - Invalid Type - Success - Warning | ## Example > ```markup > > > > > bbhDR7=mI90R+Q1Kr_??~9IesbmtnVyQ > > 0 > 100 > false > > > > > > > > > jdoe > master > > > > > ``` ## Requirements Required administrative privileges: - View Recent User Activity ## Additional references For more information about accepted recent user activities, refer to the OneSpan Authentication Server Product Guide, Section "User Dashboard".