--- title: "Get route updates" method: GET path: "/fleet/routes/audit-logs/feed" tags: ["Routes"] --- # Get route updates `GET /fleet/routes/audit-logs/feed` ## Request - Base URL: `https://api.samsara.com` - URL: `https://api.samsara.com/fleet/routes/audit-logs/feed` - Auth: HTTP bearer Subscribes to a feed of immutable, append-only updates for routes. The initial request to this feed endpoint returns a cursor, which can be used on the next request to fetch updated routes that have had state changes since that request. The legacy version of this endpoint can be found at [samsara.com/api-legacy](https://www.samsara.com/api-legacy#operation/fetchAllRouteJobUpdates). Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Routes** under the Driver Workflow category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. ## Query parameters - `after` string - `expand` 'route' ## Response `200` OK response. - RoutesGetRoutesFeedResponseBody - `data` RouteFeedObjectResponseBody[], required: Route feed response. - `changes` RouteChangesResponseBody, required: A diff of the changes for a route update. - `after` MinimalRouteAuditLogsResponseBody, required: A single route. Only the fields that have changed are present in the response. All other fields, including the route id, will not be present in the response. For now, only routeStops are included since only Route Tracking updates are supported. - `stops` MinimalRouteStopAuditLogsResponseBody[]: The route stops in the route. Only stops that have been updated will be included in the response. - `actualArrivalTime` string, date-time: Actual arrival time, if it exists, for the route stop in RFC 3339 format. - `actualDepartureTime` string, date-time: Actual departure time, if it exists, for the route stop in RFC 3339 format. - `enRouteTime` string, date-time: The time the stop became en-route, in RFC 3339 format. - `eta` string, date-time: Estimated time of arrival, if this stop is currently en-route, in RFC 3339 format. - `externalIds` object: A map of external ids - `id` string, required: Unique identifier for the route stop. - `liveSharingUrl` string: The shareable url of the stop's current status. - `scheduledArrivalTime` string, date-time: Scheduled arrival time, if it exists, for the stop in RFC 3339 format. If it does not exist, and this field was changed in the update, it will be an empty string. - `scheduledDepartureTime` string, date-time: Scheduled departure time, if it exists, for the stop in RFC 3339 format. If it does not exist, and this field was changed in the update, it will be an empty string. - `skippedTime` string, date-time: Skipped time, if it exists, for the route stop in RFC 3339 format. - `state` 'unassigned' | 'scheduled' | 'en route' | 'skipped' | 'arrived' | 'departed': The current state of the route stop. Valid values: `unassigned`, `scheduled`, `en route`, `skipped`, `arrived`, `departed` - `before` MinimalRouteAuditLogsResponseBody, required: A single route. Only the fields that have changed are present in the response. All other fields, including the route id, will not be present in the response. For now, only routeStops are included since only Route Tracking updates are supported. - `stops` MinimalRouteStopAuditLogsResponseBody[]: The route stops in the route. Only stops that have been updated will be included in the response. - `actualArrivalTime` string, date-time: Actual arrival time, if it exists, for the route stop in RFC 3339 format. - `actualDepartureTime` string, date-time: Actual departure time, if it exists, for the route stop in RFC 3339 format. - `enRouteTime` string, date-time: The time the stop became en-route, in RFC 3339 format. - `eta` string, date-time: Estimated time of arrival, if this stop is currently en-route, in RFC 3339 format. - `externalIds` object: A map of external ids - `id` string, required: Unique identifier for the route stop. - `liveSharingUrl` string: The shareable url of the stop's current status. - `scheduledArrivalTime` string, date-time: Scheduled arrival time, if it exists, for the stop in RFC 3339 format. If it does not exist, and this field was changed in the update, it will be an empty string. - `scheduledDepartureTime` string, date-time: Scheduled departure time, if it exists, for the stop in RFC 3339 format. If it does not exist, and this field was changed in the update, it will be an empty string. - `skippedTime` string, date-time: Skipped time, if it exists, for the route stop in RFC 3339 format. - `state` 'unassigned' | 'scheduled' | 'en route' | 'skipped' | 'arrived' | 'departed': The current state of the route stop. Valid values: `unassigned`, `scheduled`, `en route`, `skipped`, `arrived`, `departed` - `operation` 'stop scheduled' | 'stop en route' | 'stop skipped' | 'stop arrived' | 'stop departed' | 'stop ETA updated' | 'stop arrival time updated' | 'stop completion time updated' | 'stop order changed' | 'stop arrival prevented': The operation that was performed as part of this route update. Valid values: `stop scheduled`, `stop en route`, `stop skipped`, `stop arrived`, `stop departed`, `stop ETA updated`, `stop arrival time updated`, `stop completion time updated`, `stop order changed`, `stop arrival prevented` - `route` BaseRouteResponseObjectResponseBody, required - `actualRouteEndTime` string, date-time: Actual end time, if it exists, for the route in RFC 3339 format. - `actualRouteStartTime` string, date-time: Actual start time, if it exists, for the route in RFC 3339 format. - `driver` GoaDriverTinyResponseResponseBody: A minified driver object. This object is only returned if the route is assigned to the driver. - `externalIds` object: A map of external ids - `id` string, required: ID of the driver - `name` string: Name of the driver - `externalIds` object: A map of external ids - `id` string, required: ID of the route - `name` string: Route name - `notes` string: Notes for the route - `orgLocalTimezone` string: The local timezone, as defined in Settings for your organization. Timezones use [IANA timezone database](https://www.iana.org/time-zones) keys (e.g. `America/Los_Angeles`, `America/New_York`, `Europe/London`, etc.). You can find a mapping of common timezone formats to IANA timezone keys [here](https://unicode.org/cldr/charts/latest/supplemental/zone_tzid.html). - `recurringRouteLiveSharingLinks` LiveSharingLinkResponseObjectResponseBody[]: List of shareable, non-expired 'By recurring Route' Live Sharing Links. - `expiresAtTime` string: Date that this link expires, in RFC 3339 format. - `liveSharingUrl` string, required: The shareable URL of the vehicle's location. - `name` string, required: Name of the Live Sharing Link. - `scheduledRouteEndTime` string, date-time: Scheduled end time, if it exists, for the route in RFC 3339 format. - `scheduledRouteStartTime` string, date-time: Scheduled start time, if it exists, for the route in RFC 3339 format. - `settings` RouteSettingsResponseBody: An optional dictionary, only necessary to override the defaults for route start and end conditions. - `routeCompletionCondition` 'arriveLastStop' | 'departLastStop': Defaults to 'arriveLastStop' which ends the route upon arriving at the final stop. The condition 'departLastStop' ends the route upon departing the last stop. If 'arriveLastStop' is set, then the departure time of the final stop should not be set. Valid values: `arriveLastStop`, `departLastStop` - `routeStartingCondition` 'departFirstStop' | 'arriveFirstStop': Defaults to 'departFirstStop' which starts the route upon departing the first stop in the route. The condition 'arriveFirstStop' starts the route upon arriving at the first stop in the route. If 'departFirstStop' is set, the arrival time of the first stop should not be set. Valid values: `departFirstStop`, `arriveFirstStop` - `sequencingMethod` 'unknown' | 'scheduledArrivalTime' | 'manual': Determines how stops are sequenced on the route. 'scheduledArrivalTime' sequences stops by their scheduled arrival times (default). 'manual' allows custom sequencing via stop.sequenceNumber. 'unknown' indicates the method is not specified. Valid values: `unknown`, `scheduledArrivalTime`, `manual` - `stops` RoutesStopResponseObjectResponseBody[]: List of stops along the route - `actualArrivalTime` string, date-time: Actual arrival time, if it exists, for the route stop in RFC 3339 format. - `actualDepartureTime` string, date-time: Actual departure time, if it exists, for the route stop in RFC 3339 format. - `actualDistanceMeters` integer: Actual GPS-measured distance traveled from the previous stop's departure to this stop's arrival, in meters. Null for the first stop, skipped stops, or if GPS data is unavailable. - `address` GoaAddressTinyResponseResponseBody: A minified Address object - `externalIds` object: A map of external ids - `id` string, required: Id of the address - `name` string, required: Name of the address - `appointmentWindows` RouteStopAppointmentWindowResponseBody[]: Appointment windows for the stop. - `endTime` string, required: The end time of the appointment window for the stop in RFC 3339 format. - `startTime` string, required: The start time of the appointment window for the stop in RFC 3339 format. - `documents` GoaDocumentTinyResponseResponseBody[]: List of documents associated with the stop. - `id` string, required: Id of the document - `name` string: Name of the document - `enRouteTime` string, date-time: The time the stop became en-route, in RFC 3339 format. - `eta` string, date-time: Estimated time of arrival, if this stop is currently en-route, in RFC 3339 format. - `externalIds` object: A map of external ids - `forms` IDReferenceObjectResponseBody[]: List of forms associated with the stop. - `id` string, required: The unique identifier of the resource. - `id` string, required: Id of the stop - `issues` GoaIssueTinyResponseResponseBody[]: List of issues associated with the stop. - `id` string, required: ID of the issue - `liveSharingUrl` string: The shareable url of the stop's current status. - `locationLiveSharingLinks` LiveSharingLinkResponseObjectResponseBody[]: List of shareable, non-expired 'By Location' Live Sharing Links. - `expiresAtTime` string: Date that this link expires, in RFC 3339 format. - `liveSharingUrl` string, required: The shareable URL of the vehicle's location. - `name` string, required: Name of the Live Sharing Link. - `name` string, required: Name of the stop - `notes` string: Notes for the stop - `ontimeWindowAfterArrivalMs` integer: Specifies the time window (in milliseconds) after a stop's scheduled arrival time during which the stop is considered 'on-time'. - `ontimeWindowBeforeArrivalMs` integer: Specifies the time window (in milliseconds) before a stop's scheduled arrival time during which the stop is considered 'on-time'. - `plannedDistanceMeters` integer: Planned driving distance from the previous stop in meters. Based on routing calculations at route creation time. Null for the first stop or if routing data is unavailable. - `scheduledArrivalTime` string, date-time: Scheduled arrival time, if it exists, for the stop in RFC 3339 format. - `scheduledDepartureTime` string, date-time: Scheduled departure time, if it exists, for the stop in RFC 3339 format. - `sequenceNumber` integer: Manual sequence position of this stop. Only used when route.settings.sequencingMethod=manual. - `singleUseLocation` RoutesSingleUseAddressObjectResponseBody: This field is used to indicate stops along the route for which an address has not been persisted. This field is mutually exclusive with addressId. - `address` string: Address of the stop. - `latitude` number, double, required: The latitude of the location - `longitude` number, double, required: The longitude of the location - `radiusMeters` number: The radius in meters for the geofence around this location. Must be a positive value. - `skippedTime` string, date-time: Skipped time, if it exists, for the route stop in RFC 3339 format. - `state` 'unassigned' | 'scheduled' | 'en route' | 'skipped' | 'arrived' | 'departed', required: The current state of the route stop. Valid values: `unassigned`, `scheduled`, `en route`, `skipped`, `arrived`, `departed` - `tagIds` string[]: An array of IDs of tags to associate with this route. - `vehicle` GoaVehicleTinyResponseResponseBody: A minified vehicle object. This object is only returned if the route is assigned to the vehicle. - `externalIds` object: A map of external ids - `id` string: ID of the vehicle - `name` string: Name of the vehicle - `source` 'automatic' | 'driver' | 'admin', required: The source of this route update. Updates that are triggered by time or by the route being completed are 'automatic'. Valid values: `automatic`, `driver`, `admin` - `time` string, date-time, required: The timestamp of the route in RFC 3339 format. - `type` 'route tracking', required: The type of route update. The route tracking updates occur as a route is completed and stops transition from one state to another. Currently only Route Tracking updates are supported, but this will change in the future when additional types are added. Valid values: `route tracking` - `pagination` GoaPaginationResponseResponseBody, required: Pagination parameters. - `endCursor` string, required: Cursor identifier representing the last element in the response. This value should be used in conjunction with a subsequent request's 'after' query parameter. This may be an empty string if there are no more pages left to view. - `hasNextPage` boolean, required: True if there are more pages of results immediately available after this endCursor. ## Other responses - `401`: Unauthorized response. - `404`: Not Found response. - `405`: Method Not Allowed response. - `413`: Content Too Large response. - `429`: Too Many Requests response. - `500`: Internal Server Error response. - `501`: Not Implemented response. - `502`: Bad Gateway response. - `503`: Service Unavailable response. - `504`: Gateway Timeout response. - `default`: Bad Request response. --- [API](https://skmtc.dev/samsara/apis/samsara-api.md) - [All operations](https://skmtc.dev/samsara/apis/samsara-api/llms.txt) - [OpenAPI document](https://skmtc.dev/samsara/apis/samsara-api/revisions/a9e35d4999be?raw)