# Better Route API Changelog

*disclaimer: order by time desc*

Since its initial launch in 2023, the Better Route API has grown from a minimal core into the full public interface for Deep Integration.

This list covers changes visible to API consumers. It doesn't include the regular internal maintenance and security work we do on the API independent of this list, that happens continuously as a matter of course, not as a one-off event worth dating here.

Because we work so closely with our customers on Route pilots and deep integrations, we're also able to pick up other requests and feature ideas for the API on short notice, not just the changes listed here. If there's something you need that isn't reflected below, talk to your Bettermile contact.

### 2026

- EXTENDED: Added detailed request and response examples throughout the OpenAPI spec, making it easier for AI agents and coding assistants to integrate against the API.


### 2025

- FIXED: Requests referencing a non-existing job now correctly return `404 Not Found` instead of `500`, on [job status changes](/products/route/apis/ntc/tour-commander-api#operation/applyJobStatusChanges).
- NEW: Added a `subLocality` attribute to address payloads, for better navigation context.


### 2024

**December**

- FIXED: [Tour](/products/route/apis/ntc/tour-commander-api#operation/createTour) dates are now offset to `LocalDate`, correctly handling tours across different timezones (e.g. New Zealand vs. Berlin).


**September**

- NEW: Exposed entrance and parking coordinates on [waypoints](/products/route/apis/ntc/tour-commander-api#operation/getSequenceById), for [last-meter guidance](/products/route).
- DEPRECATED: `jobIds` in favour of a new `jobIdentifiers` field, on both the [tour](/products/route/apis/ntc/tour-commander-api#operation/getTourById) and [sequence](/products/route/apis/ntc/tour-commander-api#operation/getSequenceById) response payloads.
- NEW: [Tour responses](/products/route/apis/ntc/tour-commander-api#operation/getTourById) now include the destination address and final ETA, when a destination is set, and a Real-Time Tracking (RTT) categorisation for the tour.
- NEW: [Sequence responses](/products/route/apis/ntc/tour-commander-api#operation/getSequenceById) now include a fidelity score (how closely the driver has followed the provided sequence), and list unassigned jobs separately.
- EXTENDED: Cleaned up and extended error codes across the API for more precise client-side error handling. See the [Better Route API reference](/products/route/apis/ntc/tour-commander-api) for the current list.


**August**

- NEW: Introduced the [potential recalculation gain](/products/route/apis/ntc/tour-commander-api#operation/getPotentialRecalcGain) endpoint. See [checking for recalculation gain](/products/route/resources/deep-integration-index#checking-for-recalculation-gain) for how to use it.


**July**

- NEW: [Sequence responses](/products/route/apis/ntc/tour-commander-api#operation/getSequenceById) now include external job IDs, so clients can map jobs back to their own systems.


**June**

- NEW: Tours now default to the depot address as their [destination](/products/route/apis/ntc/tour-commander-api#operation/setTourDestination), with the option to override it. See [defining a custom destination](/products/route/resources/deep-integration-index#defining-a-custom-destination).


**May**

- NEW: Drivers can now define the [first waypoint](/products/route/resources/deep-integration-index#selecting-the-first-waypoint) of a [sequence request](/products/route/apis/ntc/tour-commander-api#operation/createSequence).


**February**

- NEW: Introduced endpoints to add, edit, and delete custom [timeframes](/products/route/apis/ntc/tour-commander-api#operation/pinWaypointTimeFrame) and [stop times](/products/route/apis/ntc/tour-commander-api#operation/pinWaypointStopTime) on waypoints. See [setting a custom timeframe](/products/route/resources/deep-integration-index#setting-a-custom-timeframe-on-a-waypoint) and [setting custom stop times](/products/route/resources/deep-integration-index#setting-custom-stop-times).
- NEW: External developers can now create [custom jobs](/products/route/apis/ntc/tour-commander-api#operation/createCustomJob) and [update job statuses](/products/route/apis/ntc/tour-commander-api#operation/applyJobStatusChanges) via the API. See [adding custom jobs](/products/route/resources/deep-integration-index#custom-jobs).


### 2023

- NEW: Added priority group information to [sequence](/products/route/apis/ntc/tour-commander-api#operation/getSequenceById) and job-level payloads.
- **Initial launch (V1)**: The Better Route API launches publicly, including [`USE_PROVIDED` mode](/products/route/apis/ntc/tour-commander-api#operation/createSequence): a way to send a specific, explicit waypoint order, unique to the API and not available in the Bettermile Driver App.