> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# OptimoRoute

> OptimoRoute is an online route optimization and planning solution for delivery, logistics, and field service companies.

![OptimoRoute logo](https://mintcdn.com/composio-preview/gqjBKmmJCINafaiK/images/toolkits/optimoroute.svg?fit=max\&auto=format\&n=gqjBKmmJCINafaiK\&q=85\&s=c75e3ca77ec408ec5082e80c088908b2)

* **Category:** project management
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 17
* **Triggers:** 0
* **Slug:** `OPTIMOROUTE`
* **Version:** 20261101\_00

## Tools

> [accordion] Create Order
>
> **Slug:** `OPTIMOROUTE_CREATE_ORDER`
>
> Tool to create a new order or update an existing order in OptimoRoute. Use when you need to add delivery, pickup, or task orders to the system with location, time windows, and other constraints.
>
> #### Input Parameters
>
> **id** `string`
>
> Unique OptimoRoute-assigned order identifier. Used for UPDATE operations
>
> **date** `string` *required*
>
> Order date in YYYY-MM-DD format
>
> **load1** `number`
>
> Load requirement 1
>
> **load2** `number`
>
> Load requirement 2
>
> **load3** `number`
>
> Load requirement 3
>
> **load4** `number`
>
> Load requirement 4
>
> **notes** `string`
>
> Service notes
>
> **skills** `array`
>
> Required driver skills
>
> **orderNo** `string`
>
> User-specified order identifier. Required unless using 'id' parameter
>
> **duration** `number`
>
> Service completion time in minutes
>
> **location** `object` *required*
>
> Delivery/service location information
>
> **priority** `string`
>
> Priority level: L (low), M (medium), H (high), or C (critical). Default: M
>
> **operation** `string` *required*
>
> Specifies action - CREATE, UPDATE, SYNC, or MERGE
>
> **orderType** `string` *required*
>
> Order type - D (delivery), P (pickup), or T (task)
>
> **timeWindows** `array`
>
> Array of time window objects
>
> **customField1** `string`
>
> Legacy custom field value 1
>
> **customField2** `string`
>
> Legacy custom field value 2
>
> **customField3** `string`
>
> Legacy custom field value 3
>
> **customField4** `string`
>
> Legacy custom field value 4
>
> **customField5** `string`
>
> Legacy custom field value 5
>
> **customFields** `object`
>
> Custom fields object with flexible data types
>
> **vehicleFeatures** `array`
>
> Required vehicle features
>
> **acceptDuplicateOrderNo** `boolean`
>
> Allow duplicate orderNo if true
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create or Update Orders
>
> **Slug:** `OPTIMOROUTE_CREATE_OR_UPDATE_ORDERS`
>
> Tool to bulk create, update, or replace multiple orders at once without geocoding. Use when you need to add new orders or modify existing ones efficiently. Supports up to 500 orders per request.
>
> #### Input Parameters
>
> **orders** `array` *required*
>
> Array of orders to create or update. Maximum 500 orders per request.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete All Orders
>
> **Slug:** `OPTIMOROUTE_DELETE_ALL_ORDERS`
>
> Tool to remove all orders and planned routes for a specified date. Use when you need to clear orders for a specific date or delete all orders system-wide if no date is provided.
>
> #### Input Parameters
>
> **date** `string`
>
> Optional date for which to remove orders and routes in YYYY-MM-DD format. If not provided, all orders system-wide will be deleted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Order
>
> **Slug:** `OPTIMOROUTE_DELETE_ORDER`
>
> Tool to remove a single order from the OptimoRoute system. Use when you need to delete a specific order by its orderNo.
>
> #### Input Parameters
>
> **orderNo** `string` *required*
>
> The user-specified identifier of the order to be deleted
>
> **forceDelete** `boolean`
>
> If true, typical restrictions on removing orders from active plans are bypassed. Defaults to false
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Orders
>
> **Slug:** `OPTIMOROUTE_DELETE_ORDERS`
>
> Tool to delete one or more orders from the system in bulk (max 500 per request). Use when you need to remove orders, either individually or in batch operations.
>
> #### Input Parameters
>
> **orders** `array` *required*
>
> List of orders to delete (max 500 per request). Each order must have either orderNo or id.
>
> **forceDelete** `boolean`
>
> If true, ignores restrictions on deleting orders from live plans. Default: false.
>
> **deleteMultiple** `boolean`
>
> If true, deletes all matches when multiple orders share the same identifier. Default: false.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Order Completion Details
>
> **Slug:** `OPTIMOROUTE_GET_COMPLETION_DETAILS`
>
> Retrieve completion status, service timing and available completion notes for up to 500 orders.
>
> #### Input Parameters
>
> **orders** `array` *required*
>
> List of order identifiers to retrieve completion details for. Maximum 500 orders per request. Each order must contain either orderNo or id.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Drivers
>
> **Slug:** `OPTIMOROUTE_GET_DRIVERS`
>
> Tool to retrieve all drivers in the system. Use when you need up-to-date driver data including status and contact information.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Mobile Events
>
> **Slug:** `OPTIMOROUTE_GET_EVENTS`
>
> Tool to retrieve mobile events from drivers' field operations. Use when you need to track order completions, status changes (success, failed, on\_duty, off\_duty), and other field events for the currently active plan.
>
> #### Input Parameters
>
> **after\_tag** `string`
>
> Marker for a prior point in time. Submit this value to retrieve only events occurring after the previous call. Leave empty for initial requests to get all events.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Orders
>
> **Slug:** `OPTIMOROUTE_GET_ORDERS`
>
> Retrieve one or more orders by identifier, including available location and driver assignment details.
>
> #### Input Parameters
>
> **orders** `array` *required*
>
> List of order identifier objects (max 500). Each object must contain either 'orderNo' or 'id' field.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Planning Status
>
> **Slug:** `OPTIMOROUTE_GET_PLANNING_STATUS`
>
> Tool to retrieve the status of an active planning/optimization process. Use when you need to check the progress of a planning job by providing its ID.
>
> #### Input Parameters
>
> **planning\_id** `integer` *required*
>
> The ID of the planning process whose status you want to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Planned Routes
>
> **Slug:** `OPTIMOROUTE_GET_ROUTES`
>
> Retrieve planned routes for a date, optionally filtered by driver or vehicle, with route parameters and stops.
>
> #### Input Parameters
>
> **route\_date** `string` *required*
>
> Date for which to retrieve routes in YYYY-MM-DD format
>
> **driver\_serial** `string`
>
> Filter results by driver's serial number
>
> **driver\_external\_id** `string`
>
> Filter results by driver's external identifier
>
> **vehicle\_registration** `string`
>
> Filter results by vehicle registration
>
> **include\_route\_polyline** `boolean`
>
> Include encoded route polyline for map display
>
> **include\_route\_start\_end** `boolean`
>
> Include route's start and end locations
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Order Scheduling Info
>
> **Slug:** `OPTIMOROUTE_GET_SCHEDULING_INFO`
>
> Tool to retrieve scheduling information for a specific order. Use when you need to check if an order is scheduled and get details like driver assignment, timing, and position.
>
> #### Input Parameters
>
> **id** `string`
>
> The unique OptimoRoute-assigned order identifier. Either orderNo or id must be provided.
>
> **orderNo** `string`
>
> The user-specified order identifier. Either orderNo or id must be provided.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Orders
>
> **Slug:** `OPTIMOROUTE_SEARCH_ORDERS`
>
> Search OptimoRoute orders by order identifiers or a date range, optionally filtering by status. At least one of identifiers or a date range is required; date ranges can span at most 35 days. Request order data or scheduling information as needed; the provider returns up to 500 orders per page.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of orders to return per request. Use with after\_tag for paginated retrieval.
>
> **orders** `array`
>
> List of order identifier objects to search for. Each object can contain either 'orderNo' or 'id' field.
>
> **afterTag** `string`
>
> Cursor for pagination. Pass the 'afterTag' value from a previous response to retrieve the next page of results.
>
> **dateRange** `object`
>
> Date range criteria for searching orders.
>
> **orderStatus** `array`
>
> Filter by order status values (e.g., 'failed', 'rejected')
>
> **includeOrderData** `boolean`
>
> When true, includes full order data in the response. Default: false.
>
> **includeScheduleInformation** `boolean`
>
> When true, includes scheduling information in the response. Default: false.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Start Planning
>
> **Slug:** `OPTIMOROUTE_START_PLANNING`
>
> Tool to start the planning/optimization process for a specified date or date range. Use when you need to generate optimized routes for orders and drivers. Requires orders to be created before planning can begin.
>
> #### Input Parameters
>
> **date** `string`
>
> Target date for planning in YYYY-MM-DD format. Required if dateRange is not specified
>
> **lockType** `string ("NONE" | "ROUTES" | "RESOURCES")`
>
> Constrains route modifications - NONE (no constraints), ROUTES (lock routes), or RESOURCES (lock resources). Default: NONE. Only applicable when startWith is CURRENT
>
> **balanceBy** `string ("WT" | "NUM")`
>
> Balancing criteria - WT (working time) or NUM (order count). Default: WT
>
> **balancing** `string ("OFF" | "ON" | "ON_FORCE")`
>
> Route balancing mode - OFF (no balancing), ON (balanced routes), or ON\_FORCE (force balancing). Default: OFF
>
> **dateRange** `object`
>
> Date range for weekly planning.
>
> **startWith** `string ("EMPTY" | "CURRENT")`
>
> EMPTY starts fresh planning, CURRENT uses existing routes. Default: EMPTY
>
> **useOrders** `array`
>
> Deprecated - use useOrderObjects instead. List of order identifiers
>
> **clustering** `boolean`
>
> Minimizes route overlap when enabled. Default: false
>
> **depotTrips** `boolean`
>
> Enables warehouse reload scheduling. Default: false
>
> **useDrivers** `array`
>
> Selected drivers to include in planning. Empty array uses all available drivers
>
> **balancingFactor** `number`
>
> Weighting for balanced routes, range 0.0-1.0. Default: 0.3
>
> **useOrderObjects** `array`
>
> Orders to optimize (maximum 500 orders per request). Each object contains either orderNo or id. Empty includes all valid orders
>
> **depotVisitDuration** `integer`
>
> Reload time at depot in minutes. Default: 0
>
> **includeScheduledOrders** `boolean`
>
> Determines handling of pre-scheduled orders. Default: true
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Stop Planning
>
> **Slug:** `OPTIMOROUTE_STOP_PLANNING`
>
> Tool to stop an active planning/optimization process. Use when you need to halt a running planning job by providing its ID.
>
> #### Input Parameters
>
> **planning\_id** `integer` *required*
>
> The ID of the planning process to be stopped
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Driver Parameters
>
> **Slug:** `OPTIMOROUTE_UPDATE_DRIVER_PARAMETERS`
>
> Update a driver's availability, work times, vehicle assignment, capacities or start/end locations. Existing routes for the driver on the specified date are unscheduled; changed start/end locations apply to all future optimizations.
>
> #### Input Parameters
>
> **date** `string` *required*
>
> Target date in YYYY-MM-DD format
>
> **enabled** `boolean`
>
> Enable or disable driver for the specified date
>
> **endAddress** `string`
>
> Ending location display address
>
> **externalId** `string` *required*
>
> Driver's external identifier from driver administration
>
> **workTimeTo** `string`
>
> End of work shift in HH:MM 24-hour format
>
> **endLatitude** `number`
>
> Ending location latitude coordinate
>
> **endLongitude** `number`
>
> Ending location longitude coordinate
>
> **startAddress** `string`
>
> Starting location display address
>
> **workTimeFrom** `string`
>
> Start of work shift in HH:MM 24-hour format
>
> **startLatitude** `number`
>
> Starting location latitude coordinate
>
> **startLongitude** `number`
>
> Starting location longitude coordinate
>
> **assignedVehicle** `string`
>
> Vehicle external identifier to assign
>
> **vehicleCapacity1** `integer`
>
> Load capacity limit for dimension 1
>
> **vehicleCapacity2** `integer`
>
> Load capacity limit for dimension 2
>
> **vehicleCapacity3** `integer`
>
> Load capacity limit for dimension 3
>
> **vehicleCapacity4** `integer`
>
> Load capacity limit for dimension 4
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Drivers Parameters
>
> **Slug:** `OPTIMOROUTE_UPDATE_DRIVERS_PARAMETERS`
>
> Update driver parameters for specified dates in bulk, including work hours, vehicle assignments and locations; existing routes for those drivers and dates are unscheduled. Provider responses may fail validation after updates are submitted.
>
> #### Input Parameters
>
> **updates** `array` *required*
>
> Array of driver parameter update objects (max 500)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
