Search routes (beta)

Beta notice : this endpoint is part of our v3-suite beta testing phase.
Please note that:

• The behavior and structure may change before public release.
• Some features or results may still be incomplete or evolving.

This endpoint generates a set of route snapshots (routeCollection) based on the provided input (type, locations, departure date, etc.). Detailed request fields are documented in the body parameters below. You can search for routes of different types:

• shortest → shortest feasible path, considering traffic separation schemes and port entries.
• historical → reconstructs past voyages around the given departureDate using AIS data.
• proforma → based on carriers service plans.
• schedule → based on upcoming carrier vessel departures.

The response will be a JSON object of type RouteCollection containing the list of the individual routes found. The route collection and the individual routes are read-only and can be used via their id to compute fuel consumption, emissions or ets.

Notes and considerations

• id lifetime: the route id remains valid for a limited period (at least 1 hour).

Support endpoints and resources

• Get routes: use the /v3/routes/{id} endpoint to retrieve an individual route by id and its details.
• Get route collections: use the /v3/routeCollections/{id} endpoint to retrieve a route collection by id and its details.
• Retrieve maritime carriers: use our Carriers endpoint to search carriers by SCAC or name.
• Find locations: use our Geocoding endpoint for location codes.