Powered by Redocly

Master - Management

Get data usage report

This API is used to get the data use report of a certain device, inputs:

serial number of the device, start and end timestamp, frequency to update the report

Securityapi key and Authorization
Request
query Parameters
sN
required
string non-empty

The serial number of device

from
required
string <date-time> non-empty
Example: from=2023-10-31T16:00:00.000Z
to
required
string <date-time> non-empty
Example: to=2023-11-31T16:00:00.999Z
frequency
required
string non-empty

The frequency of the usage repory only support daily for now

Example: frequency=day
separate
boolean

Separate the data

Example: separate=true
Responses
200

OK

get/portal/V1/ota/data-usage
Response samples
application/json
{
  • "uq": "3903dc78-9349-41a0-9662-d1e33de117f8",
  • "doc_version": "latest",
  • "result": true,
  • "code": "S00000",
  • "message": "string",
  • "build": "string",
  • "data": {
    }
}

Get user account of current Master

This API is used to get the accounts of current Master,

query with account created time, email, ID, last log in time, organization ID, role, account status, username.

Securityapi key and Authorization
Request
query Parameters
keyword
string

Query the user with keywords, which apply with the name or email of account

role
string

The user role to query, multiple role should seprate with a comma

4 = SI_Admin 5 = SI_Viewer

Example: role=4,5
status
string

The user status to query, multiple status should seprate with a comma

0 = Pending 1 = Active 2 = Deactive

Example: status=0,1,2
sort
string

The field to sort. Available fields are: name, login, created, updated

order
string (Order)

Enum of order

ASC

DESC

Enum: "ASC" "DESC"
offset
integer <int32>
Default: 0

For pagination offset

limit
integer <int32>
Default: 5

For pagination limit

Responses
200

OK

get/portal/V1/get-users
Response samples
application/json
{
  • "uq": "3903dc78-9349-41a0-9662-d1e33de117f8",
  • "doc_version": "latest",
  • "result": true,
  • "code": "S00000",
  • "message": "string",
  • "build": "string",
  • "count": 0,
  • "data": [
    ]
}

Add new master account

This API is to add a new master account, service will send an activation email to allow the user to activate its account.

User’s email address, role of the user, user name, are required.

Securityapi key and Authorization
Request
Request Body schema:
email
required
string <email> non-empty
mode
required
string non-empty

fix value: si

role
required
integer <int32> (MasterUserRole)

4 = SI_Admin

5 = SI_Viewer

Enum: 4 5
userName
required
string [ 1 .. 42 ] characters
Responses
200

OK

post/portal/V1/add-user
Request samples
{
  • "email": "user@example.com",
  • "mode": "si",
  • "role": 4,
  • "userName": "string"
}
Response samples
application/json
{
  • "uq": "3903dc78-9349-41a0-9662-d1e33de117f8",
  • "doc_version": "latest",
  • "result": true,
  • "code": "S00000",
  • "message": "string",
  • "build": "string",
  • "id": 0
}

Get user account of Fleet

This API is used to get the accounts of Fleet, information of the account:

created time, ID, user email address, last log in time, organization ID, user role, account status, and username.

Securityapi key and Authorization
Request
query Parameters
order
string (Order)

Enum of order

ASC

DESC

Enum: "ASC" "DESC"
offset
integer <int32>
Default: 0

For pagination offset

limit
integer <int32>
Default: 5

For pagination limit

fleetId
required
integer <int32>

The fleet id, A.K.A: organizaion id

keyword
string

Query the fleet user with keywords, which apply with the name or email of account

role
string
Example: role=4,5
status
string

The fleet user status to query, multiple status should seprate with a comma

0 = Pending 1 = Active 2 = Deactive

Example: status=0,1,2
sort
string

The field to sort. Available fields are: name, login, created, updated

Responses
200

OK

get/portal/V1/get-fleet-accounts
Response samples
application/json
{
  • "uq": "3903dc78-9349-41a0-9662-d1e33de117f8",
  • "doc_version": "latest",
  • "result": true,
  • "code": "S00000",
  • "message": "string",
  • "build": "string",
  • "count": 0,
  • "data": [
    ]
}

Add new fleet account

This API is to add a new fleet account, service will send an activation email to allow the user to activate its account.

User’s email address, role of the user, user name, and fleet ID are required.

This API is no longer being updated and will be removed in a future release.
Please use NewAddFleetUser instead.

Securityapi key and Authorization
Request
Request Body schema:
email
required
string <email> non-empty
role
required
integer <int32> (FleetUserRole)

The fleet user's role.

2 = Fleet_Admin

3 = Fleet_Viewer

7 = Fleet_Operator

Enum: 2 3 7
userName
required
string [ 1 .. 42 ] characters
id
required
integer <int32>

The fleet id

Responses
200

OK

post/portal/V1/add-fleet-account
Request samples
{
  • "email": "user@example.com",
  • "role": 2,
  • "userName": "string",
  • "id": 0
}
Response samples
application/json
{
  • "uq": "3903dc78-9349-41a0-9662-d1e33de117f8",
  • "doc_version": "latest",
  • "result": true,
  • "code": "S00000",
  • "message": "string",
  • "build": "string",
  • "id": 0
}

Add fleet user (New)

This API allows the master's admin to add a fleet user.

Securityapi key and Authorization
Request
Request Body schema:
first_name
required
string [ 1 .. 45 ] characters

The user's first name.

last_name
string or null [ 1 .. 45 ] characters

The user's last name.

role
required
integer <int32> (FleetUserRole)

The fleet user's role.

2 = Fleet_Admin

3 = Fleet_Viewer

7 = Fleet_Operator

Enum: 2 3 7
email_notifications_enabled
boolean or null

Specifies whether event email notifications are enabled for the user.
Applicable only to Fleet_Admin users; ignored for other roles.

email
required
string <email> non-empty

The user's email.

accessible_fleets
Array of integers or null <int32>

The fleet IDs under the master accessible to the user.

Responses
200

OK

post/portal/V1/fleet/user/add
Request samples
{
  • "first_name": "string",
  • "last_name": "string",
  • "role": 2,
  • "email_notifications_enabled": true,
  • "email": "user@example.com",
  • "accessible_fleets": [
    ]
}
Response samples
application/json
{
  • "uq": "3903dc78-9349-41a0-9662-d1e33de117f8",
  • "doc_version": "latest",
  • "result": true,
  • "code": "S00000",
  • "message": "string",
  • "build": "string",
  • "data": {
    }
}

Edit fleet account

This API is used to edit an existed fleet account with fleet ID, user role, and username.

This API is no longer being updated and will be removed in a future release.
Please use NewEditFleetUser instead.

Securityapi key and Authorization
Request
Request Body schema:
id
required
integer <int32>

The fleet id

role
required
integer <int32> (FleetUserRole)

The fleet user's role.

2 = Fleet_Admin

3 = Fleet_Viewer

7 = Fleet_Operator

Enum: 2 3 7
userName
required
string [ 1 .. 42 ] characters
Responses
200

OK

post/portal/V1/edit-fleet-account
Request samples
{
  • "id": 0,
  • "role": 2,
  • "userName": "string"
}
Response samples
application/json
{
  • "uq": "3903dc78-9349-41a0-9662-d1e33de117f8",
  • "doc_version": "latest",
  • "result": true,
  • "code": "S00000",
  • "message": "string",
  • "build": "string"
}

Edit fleet user (New)

This API allows the master's admin to add a fleet user.

Securityapi key and Authorization
Request
path Parameters
user_id
required
string
Request Body schema:
first_name
required
string [ 1 .. 45 ] characters

The user's first name.

last_name
string or null [ 1 .. 45 ] characters

The user's last name.

role
required
integer <int32> (FleetUserRole)

The fleet user's role.

2 = Fleet_Admin

3 = Fleet_Viewer

7 = Fleet_Operator

Enum: 2 3 7
email_notifications_enabled
boolean or null

Specifies whether event email notifications are enabled for the user.
Applicable only to Fleet_Admin users; ignored for other roles.

accessible_fleets
Array of integers or null <int32>

The fleet IDs under the master accessible to the user.

Responses
200

OK

post/portal/V1/fleet/user/{user_id}/edit
Request samples
{
  • "first_name": "string",
  • "last_name": "string",
  • "role": 2,
  • "email_notifications_enabled": true,
  • "accessible_fleets": [
    ]
}
Response samples
application/json
{
  • "uq": "3903dc78-9349-41a0-9662-d1e33de117f8",
  • "doc_version": "latest",
  • "result": true,
  • "code": "S00000",
  • "message": "string",
  • "build": "string",
  • "data": {
    }
}

Change status of fleet account

This API is to change status of a fleet account, to active and deactivate or delete account

Securityapi key and Authorization
Request
query Parameters
id
required
integer <int32>

The user id

status
required
integer <int32> (UserStatus)

Use for API request and output internal user statu please reference with SysUserStatus__

0 = pending

1 = active

2 = deactive

Enum: 0 1 2
Responses
200

OK

post/portal/V1/change-fleet-account-status
Response samples
application/json
{
  • "uq": "3903dc78-9349-41a0-9662-d1e33de117f8",
  • "doc_version": "latest",
  • "result": true,
  • "code": "S00000",
  • "message": "string",
  • "build": "string"
}

Change status of Master account

This API is to change status of a master account, to active and deactivate or delete account

Securityapi key and Authorization
Request
Request Body schema: multipart/form-data
id
required
integer <int32>

The user id

status
required
integer <int32> (UserStatus)

Use for API request and output internal user statu please reference with SysUserStatus__

0 = pending

1 = active

2 = deactive

Enum: 0 1 2
Responses
200

OK

post/portal/V1/change-user-status
Response samples
application/json
{
  • "uq": "3903dc78-9349-41a0-9662-d1e33de117f8",
  • "doc_version": "latest",
  • "result": true,
  • "code": "S00000",
  • "message": "string",
  • "build": "string"
}

Get inventory list

This API is used to list the device in Master's inventory (all devices associated with this master account).

Devices’ information will be retrieved, for example: IMEI 1/2, software version, last recorded GPS information…etc.

Securityapi key and Authorization
Request
query Parameters
keyword
string

Query the inventory with keywords, which apply with IMEM or serial number

model
string

Query the inventory with models(SKU). Available model(SKU) are: K145,K145C,K165,K220,K245,K245C,K265. multiple model(SKU) should seprate with a comma"

offset
integer <int32>
Default: 0

For pagination offset

limit
integer <int32>
Default: 5

For pagination limit

Responses
200

OK

get/portal/V1/inventory/list
Response samples
application/json
{
  • "count": 0,
  • "data": [
    ]
}

Assign device into fleet

To assign devices to fleet. Multiple device ids are accepted.
The device will be moved from the master's inventory into the fleet.

Securityapi key and Authorization
Request
Request Body schema: multipart/form-data
id
required
integer <int32>

Which fleet id to assign, a.k.a organization id

planType
required
string

Plan type.
Available types are Standard , Pro , Advanced

vehicleType
required
string

Assign the device with initial vehicle type Available types are passenger , medium_vehicle , heavy_duty

deviceIds
required
string

The device id or serial number or cid(certificate id) to assign. Multiple device ids are accepted, separate with a comma

region
required
string

Which region feature of AI function
Available regions are TW , US , EU , AU

Responses
200

OK

post/portal/V1/assign-devices-fleet
Response samples
application/json
{
  • "uq": "3903dc78-9349-41a0-9662-d1e33de117f8",
  • "doc_version": "latest",
  • "result": true,
  • "code": "S00000",
  • "message": "string",
  • "build": "string"
}

Get unassigned inventory list

This API is used to list devices in the Master inventory that have not been assigned to any fleet.
This endpoint provides pagination functionality and allows the use of additional query parameters to control the retrieval of subsequent data.

Securityapi key and Authorization
Request
query Parameters
keyword
string or null

Search for the device by serial number or IMEI.

plan
string or null

Search for the device by plan.
You can set multiple plans as search criteria at once, separated by commas.

Example: plan=Standard,Advanced,Pro
model
string or null

Search for the device by model.
You can set multiple models as search criteria at once, separated by commas.

Example: model=K245,K265
status
string or null

Search for the device by status.
You can set multiple status as search criteria at once, separated by commas.

Example: status=Online,Offline,Not_initiated
sort
string or null
Default: "serial_number"

The list of devices will be sorted based on what criteria.
Enum: [serial_number, recalls, camera_app_version, base_image_version, region_image_version, speedcam_version]

fleet_ids
string or null

Search for devices by their owning fleet IDs.
You can set multiple fleet IDs as search criteria at once, separated by commas.
For example, input "90,190" to search for devices belonging to fleets with IDs 90 and 190.

order
string (Order)

Enum of order

ASC

DESC

Enum: "ASC" "DESC"
page
integer or null <int32>
Default: 1

Which page

page_size
integer or null <int32> [ 1 .. 20 ]
Default: 10

Maximum number per page

Responses
200

OK

get/portal/V1/inventory/unassigned/list
Response samples
application/json
{
  • "uq": "3903dc78-9349-41a0-9662-d1e33de117f8",
  • "doc_version": "latest",
  • "result": true,
  • "code": "S00000",
  • "message": "string",
  • "build": "string",
  • "data": {
    }
}

Get assigned inventory list

This API is used to list devices in the Master inventory that have been assigned to fleets.
This endpoint provides pagination functionality and allows the use of additional query parameters to control the retrieval of subsequent data.

Securityapi key and Authorization
Request
query Parameters
keyword
string or null

Search for the device by serial number or IMEI.

plan
string or null

Search for the device by plan.
You can set multiple plans as search criteria at once, separated by commas.

Example: plan=Standard,Advanced,Pro
model
string or null

Search for the device by model.
You can set multiple models as search criteria at once, separated by commas.

Example: model=K245,K265
status
string or null

Search for the device by status.
You can set multiple status as search criteria at once, separated by commas.

Example: status=Online,Offline,Not_initiated
sort
string or null
Default: "serial_number"

The list of devices will be sorted based on what criteria.
Enum: [serial_number, recalls, camera_app_version, base_image_version, region_image_version, speedcam_version]

fleet_ids
string or null

Search for devices by their owning fleet IDs.
You can set multiple fleet IDs as search criteria at once, separated by commas.
For example, input "90,190" to search for devices belonging to fleets with IDs 90 and 190.

order
string (Order)

Enum of order

ASC

DESC

Enum: "ASC" "DESC"
page
integer or null <int32>
Default: 1

Which page

page_size
integer or null <int32> [ 1 .. 20 ]
Default: 10

Maximum number per page

Responses
200

OK

get/portal/V1/inventory/assigned-to-fleets/list
Response samples
application/json
{
  • "uq": "3903dc78-9349-41a0-9662-d1e33de117f8",
  • "doc_version": "latest",
  • "result": true,
  • "code": "S00000",
  • "message": "string",
  • "build": "string",
  • "data": {
    }
}

Autocomplete unassigned inventory list

This API is used to autocomplete search keywords for the unassigned inventory list.

Securityapi key and Authorization
Request
query Parameters
keyword
required
string >= 3 characters

Search for the device by serial number or IMEI.

Responses
200

OK

get/portal/V1/inventory/unassigned/auto-complete
Response samples
application/json
{
  • "uq": "3903dc78-9349-41a0-9662-d1e33de117f8",
  • "doc_version": "latest",
  • "result": true,
  • "code": "S00000",
  • "message": "string",
  • "build": "string",
  • "data": [
    ]
}

Autocomplete assigned inventory list

This API is used to autocomplete search keywords for the assigned inventory list.

Securityapi key and Authorization
Request
query Parameters
keyword
required
string >= 3 characters

Search for the device by serial number or IMEI.

Responses
200

OK

get/portal/V1/inventory/assigned-to-fleets/auto-complete
Response samples
application/json
{
  • "uq": "3903dc78-9349-41a0-9662-d1e33de117f8",
  • "doc_version": "latest",
  • "result": true,
  • "code": "S00000",
  • "message": "string",
  • "build": "string",
  • "data": [
    ]
}

Get fleet list

This API is used to get the fleets list under current account, including

How many account created in the fleet, account address, ID, created time, fleet ID, fleet name, phone number registered for the fleet, preferred timezone setting when system sends notification email or messages.

Securityapi key and Authorization
Request
query Parameters
order
string (Order)

Enum of order

ASC

DESC

Enum: "ASC" "DESC"
offset
integer <int32>
Default: 0

For pagination offset

limit
integer <int32>
Default: 5

For pagination limit

keyword
string

Query the fleet list with keywords, which apply with the name of fleet

Responses
200

OK

get/portal/V1/get-fleets
Response samples
application/json
{
  • "uq": "3903dc78-9349-41a0-9662-d1e33de117f8",
  • "doc_version": "latest",
  • "result": true,
  • "code": "S00000",
  • "message": "string",
  • "build": "string",
  • "count": 0,
  • "data": [
    ]
}

Get the information of fleet

This API is to get the information of a fleet, including

number of accounts created in the fleet, fleet name, fleet ID, fleet created time, email address of fleet owner, phone number of the fleet owner, preferred timezone setting when system sends notification email or messages.

Securityapi key and Authorization
Request
query Parameters
fleetId
required
string

The fleet id

Responses
200

OK

get/portal/V1/get-fleet
Response samples
application/json
{
  • "uq": "3903dc78-9349-41a0-9662-d1e33de117f8",
  • "doc_version": "latest",
  • "result": true,
  • "code": "S00000",
  • "message": "string",
  • "build": "string",
  • "data": [
    ]
}

Add a new fleet

This API is to add a new fleet

Securityapi key and Authorization
Request
Request Body schema:
fleetId
string or null
Deprecated

The name of fleet

We encourage the use of the new parameter name to replace the deprecated one, but we will continue to accept the deprecated parameter until the next revision is released.

name
required
string [ 1 .. 45 ] characters

The name of fleet

Use this parameter instead of the deprecated fleetId.

address
string or null
countryCode
string or null^\d$

telephone country code

notes
string or null
phoneNumber
string or null^\d$
Responses
200

OK

post/portal/V1/add-fleet
Request samples
{
  • "fleetId": "string",
  • "name": "string",
  • "address": "string",
  • "countryCode": "string",
  • "notes": "string",
  • "phoneNumber": "string"
}
Response samples
application/json
{
  • "uq": "3903dc78-9349-41a0-9662-d1e33de117f8",
  • "doc_version": "latest",
  • "result": true,
  • "code": "S00000",
  • "message": "string",
  • "build": "string",
  • "id": 0
}

Delete a fleet

Delete the fleet with the fleet Id

Securityapi key and Authorization
Request
Request Body schema: multipart/form-data
fleetId
required
integer <int32>
delete_fleet_data
integer <int32> [ 0 .. 1 ]
Default: 0

Specifies whether to delete all data associated with the fleet being deleted,
including devices, drivers, users, geofences, snapshots, videos, NMEA, events, trips, and other associated records or files.

When set to 1, all of the above-mentioned data will be permanently removed after the fleet is deleted.

Responses
200

OK

post/portal/V1/delete-fleet
Response samples
application/json
{
  • "uq": "3903dc78-9349-41a0-9662-d1e33de117f8",
  • "doc_version": "latest",
  • "result": true,
  • "code": "S00000",
  • "message": "string",
  • "build": "string"
}

(deprecated) Edit fleet information

This API has been deprecated;
we recommend using the new one.

Securityapi key and Authorization
Request
Request Body schema:
id
required
integer <int32>

the fleet id, a.k.a organization id

fleetId
required
string [ 1 .. 42 ] characters

the display name ID of the fleet

address
string or null
countryCode
string or null^\d$
notes
string or null

remarks

phoneNumber
string or null^\d$
timezone_notification
string or null

System will apply the fleet's prefer timezone setting when sending notification email or messages

Responses
200

OK

post/portal/V1/edit-fleet
Request samples
{
  • "id": 0,
  • "fleetId": "string",
  • "address": "string",
  • "countryCode": "string",
  • "notes": "string",
  • "phoneNumber": "string",
  • "timezone_notification": "US/Eastern"
}
Response samples
application/json
{
  • "uq": "3903dc78-9349-41a0-9662-d1e33de117f8",
  • "doc_version": "latest",
  • "result": true,
  • "code": "S00000",
  • "message": "string",
  • "build": "string"
}

Configuration list of fleet.

Securityapi key and Authorization
Request
path Parameters
fleet_id
required
string
Responses
200

OK

get/portal/V1/fleet/{fleet_id}/configurations
Response samples
application/json
{
  • "current": {
    },
  • "default": {
    },
  • "custom": {
    }
}

Update the configuration of fleet.

This API can be used to modify the configuration of fleet, ensuring that each modification will overwrite the previous settings

This configuration relies on dynamic JSON input.

Securityapi key and Authorization
Request
path Parameters
fleet_id
required
string
Request Body schema:
object (Liveview)

The Liveview configuration allows you to customize its settings.

object (EventSetting)

The Event configuration allows you to customize its settings.

object (DeviceSetting)

The Device configuration allows you to customize its settings.

Responses
200

OK

post/portal/V1/fleet/{fleet_id}/configurations
Request samples
{
  • "liveview": {
    },
  • "event": {
    },
  • "device": {
    }
}

Add fleet and admin

This API can simultaneously add fleet and admin.

Securityapi key and Authorization
Request
Request Body schema: multipart/form-data
name
required
string

Name of fleet

email
string

Email of admin

If email is empty or does not exist, the admin will not be created.

first_name
string

First name of admin

last_name
string

Last name of admin

emailNotificationsEnabled
boolean

Specifies whether to enable event email notifications for the user.
Applicable only to Fleet_Admin users.
For other roles, this parameter is ignored.

countryCode
string

Country code of fleet

phoneNumber
string

Phone number of fleet

address
string

Address of fleet

notes
string

Notes of fleet

timezoneNotification
string

The timezone when the notification is received.
If not set, the default is UTC.

logo
string <byte>

Logo of fleet

Responses
200

OK

post/portal/V1/fleet/add

Edit fleet

This API allows the admin to edit information of fleet.

Only the parameters that are passed in will be updated.

Securityapi key and Authorization
Request
path Parameters
fleet_id
required
string
Request Body schema: multipart/form-data
logo
required
string <byte>

Logo of fleet

When the string 'delete' is received, the original logo will be deleted.

name
string

Name of fleet

countryCode
string

Country code of fleet

phoneNumber
string

Phone number of fleet

address
string

Address of fleet

notes
string

Notes of fleet

timezoneNotification
string

The timezone when the notification is received.
If not set, the default is UTC.

Responses
200

OK

post/portal/V1/fleet/{fleet_id}/edit

Get device list of fleet

This API is used to get the device list of fleet,

query with device IMEI, activated time, app version, base image version, CID, device ID, device name, fleet ID, fleet name, fist connected timestamp, group ID, installation position…etc.

Securityapi key and Authorization
Request
query Parameters
order
string (Order)

Enum of order

ASC

DESC

Enum: "ASC" "DESC"
offset
integer <int32>
Default: 0

For pagination offset

limit
integer <int32>
Default: 5

For pagination limit

fleet_id
string

The fleet id to query with

keyword
string

Query the device list with keywords, which apply with imei and serial number

sort
string

The field to sort. Available fields are: serial_number

status
string

The device status to query

Not_initiated Online Offline

Example: status=Not_initiated,Online,Offline
model
string

Query the device list with models(SKU). Available model(SKU) are: K145,K145C,K165,K220,K245,K245C,K265. multiple model(SKU) should seprate with a comma"

plan
string

Query the device list with plan types. Available plan types are: Standard, Pro, Advanced, Suspend

Example: plan=Standard,Pro,Advanced
Responses
200

OK

get/portal/V1/get-group-device-list
Response samples
application/json
{
  • "count": 0,
  • "data": [
    ]
}

To update device plan type and vehicle type

This API is to update device plan type and vehicle type. Update vehicle type will be deprecated in the future

Securityapi key and Authorization
Request
Request Body schema:
deviceIds
required
string non-empty

The device id or serial number or cid(certificate id) to update. Multiple device ids are accepted, separate with a comma

vehicleType
required
string non-empty

The vehicle types. Update vehicle type will be deprecated in the future, please refer to VisionmaxVehicleTypes schema

planType
required
string non-empty

The plan type, please refer to UpdateablePlanType schema

Responses
200

OK

post/portal/V1/edit-devices-vehicle-plan
Request samples
{
  • "deviceIds": "string",
  • "vehicleType": "string",
  • "planType": "string"
}
Response samples
application/json
{
  • "uq": "3903dc78-9349-41a0-9662-d1e33de117f8",
  • "doc_version": "latest",
  • "result": true,
  • "code": "S00000",
  • "message": "string",
  • "build": "string"
}

Recall a device from fleet

This API is used to recall a device from fleet. The device will lists in Master's inventory after recall.

Need the device id to recall, can insert multiple device IDs.

Securityapi key and Authorization
Request
Request Body schema: multipart/form-data
deviceIds
required
string

The device id or serial number or cid(certificate id) to recall. Multiple device ids are accepted and should separate with a comma. The device will lists in Master's inventory after recall

delete_devices_data
integer <int32>
Default: 0

Specifies whether to delete all data associated with the device being recalled,
including snapshots, videos, NMEA, events, trips, and other associated data.

When set to 1, the above-mentioned data will be permanently removed after the device is recalled.

Responses
200

OK

post/portal/V1/recall-devices-fleet
Response samples
application/json
{
  • "uq": "3903dc78-9349-41a0-9662-d1e33de117f8",
  • "doc_version": "latest",
  • "result": true,
  • "code": "S00000",
  • "message": "string",
  • "build": "string",
  • "new_device_id": 0,
  • "old_device_id": 0,
  • "si_info": {
    }
}

Get device meta data

This API retrieves the device's metadata based on its single unit identifiers.
At least one of the parameters must be provided.

Securityapi key and Authorization
Request
query Parameters
MiTAC_SN
string or null

The serial number of device in Mitac.

customer_defined_sn_name
string

Customer-defined SN (Serial Number) name.

IMEI1
string or null

The IMEI of device.

Responses
200

OK

get/portal/V1/device/meta-data
Response samples
application/json
{
  • "uq": "3903dc78-9349-41a0-9662-d1e33de117f8",
  • "doc_version": "latest",
  • "result": true,
  • "code": "S00000",
  • "message": "string",
  • "build": "string",
  • "data": {
    }
}

Format sd card

Send a remote command to formate SD card

Securityapi key and Authorization
Request
path Parameters
cid
required
string

serial number or cid(certificate id)

Request Body schema:
type
required
string (SdCardType)

Which type to action.

MODEL SDCARD(Card 1) SDCARD_2(Card 2)
K245 ✅
K245C ✅
K220 ✅
K265/K165 ✅ ✅

SDCARD

SDCARD_2

Enum: "SDCARD" "SDCARD_2"
Responses
200

OK

post/portal/V1/device/FormatSdCardToDevice/{cid}
Request samples
{
  • "type": "SDCARD"
}
Response samples
application/json
{
  • "uq": "3903dc78-9349-41a0-9662-d1e33de117f8",
  • "doc_version": "latest",
  • "result": true,
  • "code": "S00000",
  • "message": "string",
  • "build": "string",
  • "data": {
    }
}

Get general info of devices

This can be used to retrieve general information of a device:

IMEI 1/IMEI 2, activated from, activated date/time, application version, front camera height, CID, device ID, device name, device installed location, firmware version, first connected timestamp, group ID, online status…etc. Emit the cid to retrieve the full list.

Securityapi key and Authorization
Request
query Parameters
cid
string
order
string (Order)

Enum of order

ASC

DESC

Enum: "ASC" "DESC"
offset
integer <int32>
Default: 0

For pagination offset

limit
integer <int32>
Default: 5

For pagination limit

Responses
200

OK

get/portal/V1/get-device-detail
Response samples
application/json
{
  • "uq": "3903dc78-9349-41a0-9662-d1e33de117f8",
  • "doc_version": "latest",
  • "result": true,
  • "code": "S00000",
  • "message": "string",
  • "build": "string",
  • "count": 0,
  • "data": [
    ]
}

Get health report of device

Used to fetch the last time diagnostic report of a device.

Including: assigning status, attention flag, CID, device ID, model, device name, repair flag, and report.

Securityapi key and Authorization
Request
path Parameters
cid
required
string

serial number or cid(certificate id)

Responses
200

OK

get/portal/V1/health/{cid}
Response samples
application/json
{
  • "uq": "3903dc78-9349-41a0-9662-d1e33de117f8",
  • "doc_version": "latest",
  • "result": true,
  • "code": "S00000",
  • "message": "string",
  • "build": "string",
  • "data": {
    }
}

Get the last parking snapshot photos

Get the latest parking-related event snapshots by device CID. Supports multiple camera angles.

Securityapi key and Authorization
Request
path Parameters
cid
required
string

The unique CID of the event (e.g., f2c32702-65d6-4f09-8224-9cf9a1230863)

Responses
200

OK

get/portal/V1/devices/GetLastParkingPhoto/{cid}
Response samples
application/json
{
  • "uq": "3903dc78-9349-41a0-9662-d1e33de117f8",
  • "doc_version": "latest",
  • "result": true,
  • "code": "S00000",
  • "message": "string",
  • "build": "string",
  • "data": {
    }
}

Get installed snapshot info

Fetch installed snapshot images by serial_number. Includes capture timestamp and camera angles.

Securityapi key and Authorization
Request
path Parameters
serial_number
required
string

serial number or cid(certificate id)

Responses
200

OK

get/portal/V1/devices/{serial_number}/installed-info
Response samples
application/json
{
  • "uq": "3903dc78-9349-41a0-9662-d1e33de117f8",
  • "doc_version": "latest",
  • "result": true,
  • "code": "S00000",
  • "message": "string",
  • "build": "string",
  • "data": {
    }
}

Get AI snapshot info

Fetch latest DMS and ADAS snapshots by device certificate ID (cid).

Securityapi key and Authorization
Request
query Parameters
cid
required
string

Device certificate ID

Responses
200

OK

get/portal/V1/get-device-ai
Response samples
application/json
{
  • "uq": "3903dc78-9349-41a0-9662-d1e33de117f8",
  • "doc_version": "latest",
  • "result": true,
  • "code": "S00000",
  • "message": "string",
  • "build": "string",
  • "data": {
    }
}
➔ Next to Master - Ota