Dispatches are critical to any trucking company and they ensure the goods are delivered on time and allows the drivers to be productive.

For fleet managers it is important to organize the dispatches in an effective way. They can ensure that there is maximum efficiency and minimal downtime.

This overview covers the dispatches v1 endpoints and how you can utilize them in your day to day operations.

Fetch all the company dispatch records

• Endpoint: v1/dispatches
• Description: Use this endpoint to view all the dispatches of your company. You can filter out the responses by searching for a specific driver, vehicle, id of the dispatch, or even the vendor.
• Use Case: For any fleet manager, to keep a check on the existing dispatches is crucial. This endpoint shows all the vital information of your dispatches (vendor info, driver info, consignee info, shipment details), so that you know which of your vehicle is currently on which dispatch. You can make necessary adjustments if you feel so, using the Update and existing dispatch endpoint.

Create a new dispatch

• Endpoint: v1/dispatches
• Description: Use this endpoint to create a new dispatch.
• Use Case: When you create a dispatch you must enter as many details as possible, as this will allow you to tweak the existing dispatch for modifications later. One of the important points that you need to be mindful of is the routing. A smooth dispatch involves proper routing. Motive allows you to create dispatches either with an additional stop, or no additional stops. Additional stops allow you to complete two dispatches in a single trip. For example, if you are travelling to San Francisco from Texas, you can add an additional stop at Walnut Creek (which is right on the way and does not require the driver to take a detour).
  NOTE: To create a dispatch, you must send the dispatch details as a JSON object. This endpoint will only accept JSON objects as body.

Update an existing dispatch

• Endpoint: v1/dispatches
• Description: Use this endpoint to update an existing dispatch that is currently live.
• Use Case: To make updates to an existing dispatch, you must send the entire dispatch information again as a JSON body. Paste the updated dispatch information as a JSON and enter the ID of the dispatch and the vendor ID. This will create a new dispatch and the same is relayed to your drivers.