Account
The account service provides a full list of drivers registered to your company.
For each driver, you will find useful information such as the registration date, the account details or the smartphone model.
If you have your admin API key, you can try the API via this link.
Query parameters
Field | Type | Description |
---|---|---|
pageSize |
| Number of elements to return (default: Min: |
pageNumber |
| Position of the page to return, the first page has the position : 0 (default: |
startDate |
| Minimum date of the driver data's last update (timestamp) |
endDate |
| Maximum date of the driver data's last update |
groupLabel |
| Group name (default: |
status |
| Status of the drivers (default: |
The startDate
and endDate
parameters can be used to filter the drivers based on their most recent interaction with the application. This date reflects the driver's last activity and is updated according to several criteria: last trip recorded, account or smartphone information updates.
Response
The table below summarizes the list of elements included in the response.
Field | Type | Description |
---|---|---|
data |
| List of requested driver's accounts (see below) |
totalElements |
| Total number of accounts that can be retrieved |
pageNumber |
| Position of the requested page (0 for the first page) |
pageSize |
| Requested page size (between 1000 and 20000) |
hasNext |
| Indicates whether there are more results to fetch |
Data array
The data
array contains a list of driver's account.
Field | Type | Description |
---|---|---|
userId |
| Driver's unique identifier set to initialize the DriveKit SDK |
firstname |
| Driver's firstname |
lastname |
| Driver's lastname |
pseudo |
| Driver's pseudo |
registerDate |
| Driver's registration date Date format: |
pushDataStatus |
| Driver preference for data sharing Possible values: |
groups |
| List of groups to which the driver belongs |
smartphoneData | Technical information on the driver's smartphone | |
clientData | Client related metadata | |
admin |
| Indicates if the user is an administrator on the web dashboard |
betaTester |
| Indicates if the account is a beta tester account |
Smartphone data
The smartphoneData object includes details about the driver's smartphone.
Field | Type | Description |
---|---|---|
phoneModel |
| Smartphone manufacturer codename |
appBuildNumber |
| Mobile app build number |
appVersion |
| Version of the mobile app |
osVersion |
| Version of the operating system |
osType |
| Operating system |
sdkVersion |
| DriveKit SDK version |
phoneLanguage |
| Detected phone lanquage |
rawPhoneLanguage |
| Raw phone language |
lastUpdate |
| Date of last update Date format: |
Client data
Client data consists of customer-specific metadata such as: license plate number, commercial email opt-in, contract number (formatted as a map of key-value).
Error response
Unauthorized
If the request does not contain a valid authentication token, the service will answer with a http code 401.
Bad request
If the request cannot be processed, the service will answer with a http code 400. The response body will contain more details about the error:
Message Key | Message | Description |
---|---|---|
| Invalid value for parameter 'status' | The requested status does not exist |
| Invalid value for parameter(s) '[...]' | The page size or the page number are not within the authorized range |
| Invalid group label | The requested group does not exist |
| Invalid start date | The start date is not valid, or is after the end date |
| Invalid end date | The end date is not valid |
Last updated