Activity timeline

The activity timeline service provides weekly and monthly chronological reports of the number of users in your organisation.

Weekly and monthly timelines include the following indicators:

• The total number of registered users which includes both the active and the inactive users.

• The number of new users who created an account during the given period.

• The number of active users: who recorded at least one trip during the given period.

• the number of deleted users during the given period.

If you have your admin API key, you can try the API via this link.

Customer activity timeline

Get weekly and monthly chronological reports of the number of users in your organisation.

GEThttps://service.drivequant.com/v3/drivekit/admin/customer/activity/timeline

Header parameters

Response

200401

OK

Body

application/json

weekCustomerActivityTimelineItem

monthCustomerActivityTimelineItem

Request

JavaScriptCurl

const response = await fetch('https://service.drivequant.com/v3/drivekit/admin/customer/activity/timeline', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "week": {
    "date": [
      "2024-05-03T02:43:22.894Z"
    ],
    "registeredUsers": [],
    "newUsers": [],
    "deletedUsers": [],
    "activeUsers": []
  },
  "month": {
    "date": [
      "2024-05-03T02:43:22.894Z"
    ],
    "registeredUsers": [],
    "newUsers": [],
    "deletedUsers": [],
    "activeUsers": []
  }
}

Response

The table below summarizes the list of activity data.

Field	Type	Description
week	object	List of weekly activity (see CustomerActivityTimelineItem)
month	object	List of monthly activity (see CustomerActivityTimelineItem)

CustomerActivityTimelineItem

The monthly and weekly activity has the same structure, represented by a CustomerActivityTimelineItem object described in the table below.

Field	Type	Description
date	array[string]	Dates corresponding to the first day of the week or month. Date format: YYYY-MM-dd’T’HH:mm:ss.SSSZ
registeredUsers	array[int]	Total number of registered users.
newUsers	array[int]	Number of new users in the given period.
deletedUsers	array[int]	Number of users having their accounts deleted in the given period.
activeUsers	array[int]	Number of active users who recorded at least one trip during the given period.