---
title: "Get vessel future positions from coordinates"
method: GET
path: "/vessels/{id}/future_positions_with_coordinates"
tags: ["Routing (Paid)", "Vessels"]
---

# Get vessel future positions from coordinates

`GET /vessels/{id}/future_positions_with_coordinates`

Returns the estimated route between two ports for a given vessel from a set of coordinates. <Warning> The timestamp of the positions has fixed spacing of one minute.</Warning> <Note>This is a paid feature. Please contact sales@terminal49.com.</Note>

## Query parameters

- `port_id` string, uuid, required
- `previous_port_id` string, uuid, required
- `latitude` number, required
- `longitude` number, required

## Response `200`

OK

- object
  - `data` VesselWithPositions
    - `id` string, uuid, required
    - `type` 'vessel', required
    - `attributes` object, required
      - `name` string — The name of the ship or vessel
      - `imo` string, nullable — International Maritime Organization (IMO) number
      - `mmsi` string, nullable — Maritime Mobile Service Identity (MMSI)
      - `latitude` number, nullable — The current latitude position of the vessel
      - `longitude` number, nullable — The current longitude position of the vessel
      - `nautical_speed_knots` number, nullable — The current speed of the ship in knots (nautical miles per hour)
      - `navigational_heading_degrees` number, nullable — The current heading of the ship in degrees, where 0 is North, 90 is East, 180 is South, and 270 is West
      - `position_timestamp` string, date-time, nullable — The timestamp of when the ship's position was last recorded, in ISO 8601 date and time format
      - `positions` object[] — Array of estimated future positions
        - `latitude` number, required
        - `longitude` number, required
        - `heading` number, nullable
        - `timestamp` string, date-time, required
        - `estimated` boolean, required
  - `links` object
    - `self` string, uri

## Other responses

- `403` — Forbidden - Routing data feature is not enabled for this account

---

[API](https://skmtc.net/terminal49/apis/terminal49-api-reference.md) · [All operations](https://skmtc.net/terminal49/apis/terminal49-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/terminal49/terminal49-api-reference/versions/05ac7931d5a1/schema)