Activity

An activity represents a planned job/order. Once a route is saved, an activity is alse persisted along with it. It stores information about the location for tasks to be executed for an order.

Fields

job

A reference to the associated order.

location_id

A reference to location

logs

A collection of reference to activity logs.

status

Activity status. One of CREATED, COMPLETED, FAILED.

• CREATED implies the activity is planned and has not been attempted
• COMPLETED implies the activity was fulfilled
• FAILED implies that fulfilment was attempted and did not succeed

An activity is one stop's worth of work. A FAILED activity does not end the route — the route still closes — and it does not end the order either. See the order lifecycle.

status_at

Time stamp for when the status was updated

status_description

A text description of current status

task_id

Reference to task.

time

An array with start and end times

example

{
  ...
  "time": ["2025-09-25T04:00:00.000Z", "2025-09-25T05:00:00.000Z"]
  ...
}