Dispatch locations represent the various points where dispatch operations—such as loading, unloading, restocking, or driver reassignment—take place.

Fetch a list of all the company dispatches

• Endpoint: v1_dispatch_locations
• Description: This API endpoint retrieves a list of all dispatch locations associated with a company. This list can provide essential information about each dispatch point, including addresses, geographical coordinates, contact details, and any other relevant operational information.
• Use Case: By using this endpoint, Fleet Managers can pull all company dispatch locations and analyze them to assign drivers efficiently, reduce travel times, and improve overall logistics efficiency. Additionally, this endpoint can assist with:
  • Route Optimization: Creating the shortest or most cost-effective routes for drivers based on dispatch locations.
  • Resource Allocation: Efficiently assigning vehicles and drivers to different dispatch points based on location and capacity.
  • Real-Time Updates: Keeping drivers informed about updated dispatch points or new locations as they are added to the company’s logistics network.

Create a dispatch location

• Endpoint: v1/dispatch_locations
• Description: When a dispatch location is created, it allows fleet managers to define specific locations where drivers or goods can be dispatched, received, or routed.
• Use Case: This endpoint allows the fleet managers to inform their drivers where to pick up or drop off goods the goods. There are two types of dispatch locations in Motive:
  • Geo-coded dispatch locations
  • Non-Goecoded dipatch locations

Update an existing dispatch location

• Endpoint: v1/dispatch_locations
• Description: This endpoint allows fleet managers to update the details of an existing dispatch location. This feature ensures that dispatch location data remains accurate and up-to-date for efficient fleet routing and dispatch management.
• Use Case: To ensure drivers and dispatch teams have access to the latest information, Fleet Managers use this endpoint to update the dispatch location’s operational hours and notes. This enables more efficient scheduling, and ensures that drivers are informed, preventing delays due to outdated location details.

Delete an existing dispatch location

• Endpoint: v1/dispatch_locations
• Description: This endpoint removes a specified dispatch location from the company's list of dispatch points. When a dispatch location is no longer in use, deleting it ensures that drivers and dispatch systems do not route to that location, preventing confusion and inefficiencies in route planning.
• Use Case: If a warehouse in a particular location has closed and is no longer used for dispatch operations, the fleet manager uses this endpoint to delete it. This update reduces routing errors, keeps dispatch data organized, and enhances the overall efficiency of the fleet’s operational network.