Events APIs

Events APIs allow you to retrieve and manage driver duty status events, such as on_duty and off_duty. These APIs help fleet managers review driver activity and allow external time-tracking systems to synchronize duty status information with Motive.

This overview covers the Events category endpoints.

Fetch a list of all events

• Endpoint: GET /v1/events
• Description: Retrieves a company’s duty status events in reverse chronological order.
• Use Case: Review driver duty status history for a specific date range or set of drivers.

Create an event

• Endpoint: POST /v1/events
• Description: Creates an on_duty or off_duty event for a driver.
• Use Case: Synchronize clock-in and clock-out activity from an external time-tracking system.

Update an event

• Endpoint: PUT /v1/events/:id
• Description: Updates an existing on_duty or off_duty event.
• Use Case: Correct or update event details such as the timestamp, notes, or location.

Delete an event

• Endpoint: DELETE /v1/events/:id
• Description: Deletes an event created through the Public API.
• Use Case: Remove an API-created duty status event that is no longer valid.