POST api/hire/requestutilisation

Request the utilisation of equipment

Request Information

URI Parameters

None.

Body Parameters

A RequestUtilisationModel

Name	Description	Type	Additional information
token	The token returned after login used for authentication	string	None.
userID	The userid returned after login used for authentication	unsigned integer	None.
serviceID	The service id of the unit can be provided instead of ecode/comm code	unsigned integer	None.
ecode	The ecode used to identify equipment	string	None.
commCode	The comm code used to identify equipment	string	None.
startDate	The start date for the query	date	None.
endDate	The end date for the query	date	None.

Request Formats

application/json, text/json

Sample:

{
  "token": "sample string 1",
  "userID": 2,
  "serviceID": 3,
  "ecode": "sample string 4",
  "commCode": "sample string 5",
  "startDate": "2025-10-30T14:03:22.3783183+00:00",
  "endDate": "2025-10-30T14:03:22.3783183+00:00"
}

application/xml, text/xml

Sample:

<RequestUtilisationModel 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>
  <serviceID>3</serviceID>
  <ecode>sample string 4</ecode>
  <commCode>sample string 5</commCode>
  <startDate>2025-10-30T14:03:22.3783183+00:00</startDate>
  <endDate>2025-10-30T14:03:22.3783183+00:00</endDate>
</RequestUtilisationModel>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

A UtilisationResponseModel

UtilisationResponseModel

Name	Description	Type	Additional information
lastOperator	The last operator of the equipment	string	None.
utilisationTime	The time the equipment has been used for in seconds	decimal number	None.
chargeScore	The daily charge score	decimal number	None.
batteryLevel	The last battery level in volts recorded	decimal number	None.
waterUsed	The water used in litres for the current day	decimal number	None.
areaCleaned	The area cleaned for the current day in meters squared	decimal number	None.

Response Formats

application/json, text/json

Sample:

{
  "lastOperator": "sample string 1",
  "utilisationTime": 2.1,
  "chargeScore": 3.1,
  "batteryLevel": 4.1,
  "waterUsed": 5.1,
  "areaCleaned": 6.1
}

application/xml, text/xml

Sample:

<UtilisationResponseModel xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <lastOperator>sample string 1</lastOperator>
  <utilisationTime>2.1</utilisationTime>
  <chargeScore>3.1</chargeScore>
  <batteryLevel>4.1</batteryLevel>
  <waterUsed>5.1</waterUsed>
  <areaCleaned>6.1</areaCleaned>
</UtilisationResponseModel>