POST api/mobile/mobileservice
Get information about the services in a group or a list of services
Request Information
URI Parameters
None.
Body Parameters
A MobileServiceRequest
MobileServiceRequest| Name | Description | Type | Additional information |
|---|---|---|---|
| Token |
The token returned after login used for authentication |
string |
None. |
| UserID |
The user id returned after login used for authentication |
unsigned integer |
None. |
| GroupID |
The group id being queried |
unsigned integer |
None. |
| ServiceIDs |
A list of service ids. If any services are specified this takes priority over a group id supplied |
Collection of unsigned integer |
None. |
Request Formats
application/json, text/json
{
"Token": "sample string 1",
"UserID": 2,
"GroupID": 3,
"ServiceIDs": [
1,
2
]
}
application/xml, text/xml
<MobileServiceRequest xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Token>sample string 1</Token>
<UserID>2</UserID>
<GroupID>3</GroupID>
<ServiceIDs>
<unsignedLong>1</unsignedLong>
<unsignedLong>2</unsignedLong>
</ServiceIDs>
</MobileServiceRequest>
application/x-www-form-urlencoded
Sample not available.
Response Information
Resource Description
A collection of MobileServiceResponses
Collection of MobileServiceResponse| Name | Description | Type | Additional information |
|---|---|---|---|
| ID |
The service ID |
unsigned integer |
None. |
| Registration |
The service registration |
string |
None. |
| VIN |
Vehicle Identification Number |
string |
None. |
| IconURL |
The service icon url, will use v5 icon if possible |
string |
None. |
| GPSOrientation |
The GPS orientation in degrees |
decimal number |
None. |
| GPSLatitude |
The GPS latitude in degrees |
decimal number |
None. |
| GPSLongitude |
The GPS longitude in degrees |
decimal number |
None. |
| GPSSpeed |
The GPS speed in miles per hour |
decimal number |
None. |
| GPSTime |
The GPS time in UTC |
date |
None. |
| POI |
The name of a POI if the service is inside one |
string |
None. |
| Street |
The street where the service is located |
string |
None. |
| Town |
The town where the service is located |
string |
None. |
| Postcode |
The postcode where the service is located |
string |
None. |
| Country |
The country where the service is located |
string |
None. |
| JourneyStatus |
Indicates if the service is in a journey |
boolean |
None. |
| IdleStatus |
Indicates if the service is idling |
boolean |
None. |
| AssetsAssociated |
A collection of assets current associated to the service |
Collection of MobileAssetResponse |
None. |
| DeviceType |
The type of the device associated to the service |
None. |
Response Formats
application/json, text/json
[
{
"ID": 1,
"Registration": "sample string 2",
"VIN": "sample string 3",
"IconURL": "sample string 4",
"GPSOrientation": 5.1,
"GPSLatitude": 6.1,
"GPSLongitude": 7.1,
"GPSSpeed": 8.1,
"GPSTime": "2025-11-04T14:26:03.1353807+00:00",
"POI": "sample string 10",
"Street": "sample string 11",
"Town": "sample string 12",
"Postcode": "sample string 13",
"Country": "sample string 14",
"JourneyStatus": true,
"IdleStatus": true,
"AssetsAssociated": [
{
"ID": 1,
"Name": "sample string 2",
"TyrePressure": 3.1,
"Temperature": 4.1,
"AssetType": 1
},
{
"ID": 1,
"Name": "sample string 2",
"TyrePressure": 3.1,
"Temperature": 4.1,
"AssetType": 1
}
],
"DeviceType": 0,
"ConfigurationID": 18,
"BatteryStatus": 0,
"BatteryStatusV2": 0,
"Voltage": 19.1,
"LocationAccuracy": 20,
"RecoveryProvider": {
"Name": "sample string 1",
"PhoneNumber": "sample string 2"
},
"Recovering": true,
"CameraCount": 22,
"IMEI": "sample string 23",
"CameraDetails": {
"HostAddress": "sample string 1",
"HostPort": 2,
"Username": "sample string 3",
"Password": "sample string 4",
"ExternalDeviceId": "sample string 5",
"NumberOfCameras": 6
},
"OutputStates": {
"Output0State": true,
"Output0Label": "sample string 2",
"Output1State": true,
"Output1Label": "sample string 4",
"Output2State": true,
"Output2Label": "sample string 6",
"Output3State": true,
"Output3Label": "sample string 8"
},
"ExternalDeviceTypes": [
0,
0
]
},
{
"ID": 1,
"Registration": "sample string 2",
"VIN": "sample string 3",
"IconURL": "sample string 4",
"GPSOrientation": 5.1,
"GPSLatitude": 6.1,
"GPSLongitude": 7.1,
"GPSSpeed": 8.1,
"GPSTime": "2025-11-04T14:26:03.1353807+00:00",
"POI": "sample string 10",
"Street": "sample string 11",
"Town": "sample string 12",
"Postcode": "sample string 13",
"Country": "sample string 14",
"JourneyStatus": true,
"IdleStatus": true,
"AssetsAssociated": [
{
"ID": 1,
"Name": "sample string 2",
"TyrePressure": 3.1,
"Temperature": 4.1,
"AssetType": 1
},
{
"ID": 1,
"Name": "sample string 2",
"TyrePressure": 3.1,
"Temperature": 4.1,
"AssetType": 1
}
],
"DeviceType": 0,
"ConfigurationID": 18,
"BatteryStatus": 0,
"BatteryStatusV2": 0,
"Voltage": 19.1,
"LocationAccuracy": 20,
"RecoveryProvider": {
"Name": "sample string 1",
"PhoneNumber": "sample string 2"
},
"Recovering": true,
"CameraCount": 22,
"IMEI": "sample string 23",
"CameraDetails": {
"HostAddress": "sample string 1",
"HostPort": 2,
"Username": "sample string 3",
"Password": "sample string 4",
"ExternalDeviceId": "sample string 5",
"NumberOfCameras": 6
},
"OutputStates": {
"Output0State": true,
"Output0Label": "sample string 2",
"Output1State": true,
"Output1Label": "sample string 4",
"Output2State": true,
"Output2Label": "sample string 6",
"Output3State": true,
"Output3Label": "sample string 8"
},
"ExternalDeviceTypes": [
0,
0
]
}
]
application/xml, text/xml
<ArrayOfMobileServiceResponse xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<MobileServiceResponse>
<ID>1</ID>
<Registration>sample string 2</Registration>
<VIN>sample string 3</VIN>
<IconURL>sample string 4</IconURL>
<GPSOrientation>5.1</GPSOrientation>
<GPSLatitude>6.1</GPSLatitude>
<GPSLongitude>7.1</GPSLongitude>
<GPSSpeed>8.1</GPSSpeed>
<GPSTime>2025-11-04T14:26:03.1353807+00:00</GPSTime>
<POI>sample string 10</POI>
<Street>sample string 11</Street>
<Town>sample string 12</Town>
<Postcode>sample string 13</Postcode>
<Country>sample string 14</Country>
<JourneyStatus>true</JourneyStatus>
<IdleStatus>true</IdleStatus>
<AssetsAssociated>
<MobileAssetResponse>
<ID>1</ID>
<Name>sample string 2</Name>
<TyrePressure>3.1</TyrePressure>
<Temperature>4.1</Temperature>
<AssetType>Driver</AssetType>
</MobileAssetResponse>
<MobileAssetResponse>
<ID>1</ID>
<Name>sample string 2</Name>
<TyrePressure>3.1</TyrePressure>
<Temperature>4.1</Temperature>
<AssetType>Driver</AssetType>
</MobileAssetResponse>
</AssetsAssociated>
<DeviceType>Default</DeviceType>
<RawConfiguration>sample string 17</RawConfiguration>
<ConfigurationID>18</ConfigurationID>
<BatteryStatus>Full</BatteryStatus>
<BatteryStatusV2>Full</BatteryStatusV2>
<Voltage>19.1</Voltage>
<LocationAccuracy>20</LocationAccuracy>
<RecoveryProvider>
<Name>sample string 1</Name>
<PhoneNumber>sample string 2</PhoneNumber>
</RecoveryProvider>
<Recovering>true</Recovering>
<CameraCount>22</CameraCount>
<IMEI>sample string 23</IMEI>
<CameraDetails>
<HostAddress>sample string 1</HostAddress>
<HostPort>2</HostPort>
<Username>sample string 3</Username>
<Password>sample string 4</Password>
<ExternalDeviceId>sample string 5</ExternalDeviceId>
<NumberOfCameras>6</NumberOfCameras>
</CameraDetails>
<OutputStates>
<Output0State>true</Output0State>
<Output0Label>sample string 2</Output0Label>
<Output1State>true</Output1State>
<Output1Label>sample string 4</Output1Label>
<Output2State>true</Output2State>
<Output2Label>sample string 6</Output2Label>
<Output3State>true</Output3State>
<Output3Label>sample string 8</Output3Label>
</OutputStates>
<ExternalDeviceTypes>
<ExternalDeviceType>HD22Camera</ExternalDeviceType>
<ExternalDeviceType>HD22Camera</ExternalDeviceType>
</ExternalDeviceTypes>
</MobileServiceResponse>
<MobileServiceResponse>
<ID>1</ID>
<Registration>sample string 2</Registration>
<VIN>sample string 3</VIN>
<IconURL>sample string 4</IconURL>
<GPSOrientation>5.1</GPSOrientation>
<GPSLatitude>6.1</GPSLatitude>
<GPSLongitude>7.1</GPSLongitude>
<GPSSpeed>8.1</GPSSpeed>
<GPSTime>2025-11-04T14:26:03.1353807+00:00</GPSTime>
<POI>sample string 10</POI>
<Street>sample string 11</Street>
<Town>sample string 12</Town>
<Postcode>sample string 13</Postcode>
<Country>sample string 14</Country>
<JourneyStatus>true</JourneyStatus>
<IdleStatus>true</IdleStatus>
<AssetsAssociated>
<MobileAssetResponse>
<ID>1</ID>
<Name>sample string 2</Name>
<TyrePressure>3.1</TyrePressure>
<Temperature>4.1</Temperature>
<AssetType>Driver</AssetType>
</MobileAssetResponse>
<MobileAssetResponse>
<ID>1</ID>
<Name>sample string 2</Name>
<TyrePressure>3.1</TyrePressure>
<Temperature>4.1</Temperature>
<AssetType>Driver</AssetType>
</MobileAssetResponse>
</AssetsAssociated>
<DeviceType>Default</DeviceType>
<RawConfiguration>sample string 17</RawConfiguration>
<ConfigurationID>18</ConfigurationID>
<BatteryStatus>Full</BatteryStatus>
<BatteryStatusV2>Full</BatteryStatusV2>
<Voltage>19.1</Voltage>
<LocationAccuracy>20</LocationAccuracy>
<RecoveryProvider>
<Name>sample string 1</Name>
<PhoneNumber>sample string 2</PhoneNumber>
</RecoveryProvider>
<Recovering>true</Recovering>
<CameraCount>22</CameraCount>
<IMEI>sample string 23</IMEI>
<CameraDetails>
<HostAddress>sample string 1</HostAddress>
<HostPort>2</HostPort>
<Username>sample string 3</Username>
<Password>sample string 4</Password>
<ExternalDeviceId>sample string 5</ExternalDeviceId>
<NumberOfCameras>6</NumberOfCameras>
</CameraDetails>
<OutputStates>
<Output0State>true</Output0State>
<Output0Label>sample string 2</Output0Label>
<Output1State>true</Output1State>
<Output1Label>sample string 4</Output1Label>
<Output2State>true</Output2State>
<Output2Label>sample string 6</Output2Label>
<Output3State>true</Output3State>
<Output3Label>sample string 8</Output3Label>
</OutputStates>
<ExternalDeviceTypes>
<ExternalDeviceType>HD22Camera</ExternalDeviceType>
<ExternalDeviceType>HD22Camera</ExternalDeviceType>
</ExternalDeviceTypes>
</MobileServiceResponse>
</ArrayOfMobileServiceResponse>