GET Status

Get user status data from the Relationship Intelligence system for enabled users. Returns the specified user’s email address, last email sync date and last meeting sync date.

If no user is specified, this endpoint returns all users that have been enabled for relationship scoring.

Params

nameParam typeData TypeExampleRequired
userIdsQueryint(array)101optional

Request all users

GET {{host}}/api/rest/v4/ri/import/status
Authorization: {{auth}}

Request specified users

GET {{host}}/api/rest/v4/ri/import/status
?userIds=101
Authorization: {{auth}}

Response

HTTP/1.1 200 OK
[
  {
    "userId": 101,
    "emailAddress": "string",
    "lastEmailSyncDate": "2024-03-25T20:18:59.012Z",
    "lastMeetingSyncDate": "2024-03-25T20:18:59.012Z"
  }
]
 

Errors

HTTP/1.1 401 Unauthorized
{
  "message": "Cannot perform the action. User capabilities are required: AccessRiWebService""
}
HTTP/1.1 400 Bad Request
{
  "message": "API must be selected as the Exchange connection type to use this API endpoint"
}
HTTP/1.1 400 Bad Request
{
  "message": "Email or Event collection must be enabled to use this API endpoint"
}