Skip Navigation
  1. BlackBerry Docs
  2. Cylance products
  3. Cylance User API guide
  4. Persona Desktop API
  5. Get Persona Desktop user scores for given date range

Get
Persona Desktop
 user scores for given date range

Request all model score events for a given device and for a specific
Persona Desktop
 user, within a given date range, belonging to a tenant.
Service endpoint
https://persona-{region-code}.cylance.com/persona-client-scores?userId={personadesktop_userid}&deviceId={deviceId}&fromTime={from_time}­&toTime={to_time}&includeMeta=true&page=m&pageSize=n
Optional query string parameters
  • includeMeta: This includes the meta section at the end of the response when set to true. The meta section includes the page number, the page size, the total number of pages, and the total number of records.
  • page: This is the page number to request.
  • pageSize: This is the number of user records to retrieve per page.
Example
https://persona.cylance.com/persona-client-scores?userId=8DC8D2C3C47E2623E4E3A24B4C65F801&deviceId=BDE678C873­3143BD974DB209F31F3FFD&fromTime=2021-07-20T13:07:40Z­&toTime=2021-08-06T15:44:19Z&includeMeta=true&page=1&pageSize=100
Method
HTTP/1.1 GET
Request headers
  • Accept: application/json
  • Authorization: Bearer
    JWT Token returned by Auth API
     with the personausers:list scope encoded

Request

None

Response

Please see the Response status codes for more information.

Response JSON schema

Field Name
Description
deviceId
This is the unique identifier of the device the
Persona Desktop
 user logged in to.
score
This is the
Persona Desktop
 user's score for a score type.
scoreType
This is the trust score for the event.
timestamp
This is the date and time (in UTC) when the score was recorded.
userId
This is the unique identifier of the
Persona Desktop
 user.