> ## Documentation Index
> Fetch the complete documentation index at: https://terminal49-vorflux-dev-12120-supported-document-types.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get vessel future positions

> Retrieve a vessel's estimated future route between two ports from the Terminal49 API, returning a sequence of positions spaced one minute apart.

<Note>
  This is a paid Routing Data endpoint. See [Entitlements and Paid Features](/api-docs/useful-info/entitlements) for access requirements and non-entitled responses.
</Note>

This endpoint requires the destination port ID (`port_id`) and the previous port ID (`previous_port_id`) for the vessel leg you want to forecast.

## How to find the port IDs

If you are starting from a tracked container, call [`GET /v2/containers/{id}/map_geojson`](/api-docs/api-reference/containers/get-container-map-geojson) and inspect the `port` features. Each port feature includes:

* `properties.location_id` - the port UUID to pass as `port_id` or `previous_port_id`
* `properties.ports_sequence` - the route order
* `properties.label` - route label such as `POL`, `POD`, or transshipment labels

Use the destination port's `location_id` as `port_id`, and the preceding port's `location_id` as `previous_port_id`.