---
title: "Get estimated route polyline"
method: GET
path: "/orders/estimated-routes/{estimated_route_id}"
tags: ["Orders"]
---

# Get estimated route polyline

`GET /orders/estimated-routes/{estimated_route_id}`

## Request

- Base URL: `https://v3.api.hypertrack.com`
- URL: `https://v3.api.hypertrack.com/orders/estimated-routes/{estimated_route_id}`
- Auth: one of:
  - HTTP basic
  - HTTP bearer
- TypeScript: <https://skmtc.dev/hypertrack/apis/hypertrack-api/docs/orders/estimated-routes/:estimated_route_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve the route polyline for an estimated route by its ID.

    The `estimated_route_id` is provided in `eta_change` and `eta_change_v2` webhooks.
    Use this endpoint to fetch the route polyline that was used for the ETA calculation.

    The response includes:
    - The route polyline as a GeoJSON LineString
    - Start and end locations
    - Total distance (meters) and duration (seconds) of the route

## Path parameters

- `estimated_route_id` string, required

## Response `200`

Successful response

- GetEstimatedRouteResponse
  - `estimated_route_id` string, required: The unique identifier for this estimated route
  - `polyline` union: GeoJSON LineString representing the route polyline with [longitude, latitude] coordinates
    - Polyline
      - `type` string, required: Type of GeoJSON feature. It will always be `LineString` for polyline
      - `coordinates` array[], required: GeoJSON representation of LineString coordinates, inner list element is represented as [longitude, latitude, altitude, recorded_at]
        - unknown[]
          - unknown
    - unknown
  - `start_location` union: The starting location of the route
    - LocationGeometryResponse
      - `type` string, required: Geometry type
      - `coordinates` unknown[], required: Location coordinates represented as list of [longitude, latitude].
        - unknown
    - unknown
  - `end_location` union: The ending/destination location of the route
    - LocationGeometryResponse
      - `type` string, required: Geometry type
      - `coordinates` unknown[], required: Location coordinates represented as list of [longitude, latitude].
        - unknown
    - unknown
  - `distance` integer, nullable: Total distance of the route in meters
  - `duration` integer, nullable: Estimated duration of the route in seconds

## Other responses

- `401`: Authentication error
- `404`: Not found

---

[API](https://skmtc.dev/hypertrack/apis/hypertrack-api.md) - [All operations](https://skmtc.dev/hypertrack/apis/hypertrack-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hypertrack/apis/hypertrack-api/revisions/389326c4c9c8?raw)