post https://example.com/eld/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 “” does not exist. *Check to make sure that the user you are trying to update exists |
| Insert <On, Off> duty status failed. externalUserId “” 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 “” does not exist. *Check to make sure that the user you are trying to update exists |
| Insert <On, Off> duty status failed. Requested datetime “” is more than 24 hours in the past. |
| Insert <On, Off> duty status failed. Requested datetime “” is not a correctly formatted ISO 8601 datetime. |
| Insert duty status failed. Event type, “” not valid. Please use either “OFF” or “ON”. |
| Insert <On, Off> duty status failed. Driver has already certified log related to . |
| Insert <On, Off> duty status failed. Driver in drive, PC or YM at the requested insertion time, “”. |
| Insert <On, Off> duty status failed. Invalid JSON. |
| Insert <On, Off> duty status failed. Other system error. |