POST /hos/dutystatus

The post duty status API enables the setting of a user’s duty status to On Duty or Off Duty.

🚧

FMCSA Compliance Note

To ensure compliance with the ELD Mandate, only authenticated users may change their duty status and changing duty status must be triggered by a driver's action and not done through scheduled or automatic means. Fleets and carriers are ultimately responsible for maintaining accurate ELD logs and for ensuring that the use of this endpoint is compliant with FMCSA requirements.

400 Failure Descriptions

If a request to insert a duty status fails, one of the following failure messages will be sent back in the HTTP response.

Failure Descriptions

Insert <On, Off> duty status failed. externalUserId <requested user id> does not exist.

  • Check to make sure that the user you are trying to update exists

Insert <On, Off> duty status failed. externalUserId <requested user id> is not configured for ELD use.

  • Check to make sure that the user you are trying to update had ELD permissions.

Insert <On, Off> duty status failed. externalVehicleId <requested vehicle id> does not exist.

  • Check to make sure that the user you are trying to update exists

Insert <On, Off> duty status failed. Requested datetime <requested date time> is more than 24 hours in the past.

Insert <On, Off> duty status failed. Requested datetime <requested date time> is not a correctly formatted ISO 8601 datetime.

Insert duty status failed. Event type, <event type> not valid. Please use either “OFF” or “ON”.

Insert <On, Off> duty status failed. Driver has already certified log related to <requested date time>.

Insert <On, Off> duty status failed. Driver in drive, PC or YM at the requested insertion time, <requested date time>.

Insert <On, Off> duty status failed. Invalid JSON.

Insert <On, Off> duty status failed. Other system error.

Language
Click Try It! to start a request and see the response here!