Compute fuel consumption for shipment on route (beta)

Compute fuel consumption for shipment on route.
This endpoint uses the route id retrieved from /v3/routes, computing fuel of the saved route snapshot.

Notes and considerations

  • id lifetime: the route id remains valid for a limited period (at least 1 hour), following the same policy as any v3/route sub-resources.
  • Fuel consumption is estimated from the distance travelled in each area (ECA vs non-ECA) and the technical characteristics of the vessel(s) assigned to the route.
  • Availability of the fuel consumption computation by route type:
    • historical: available, based on the vessel(s) that performed the voyage.
    • schedule: available, based on the vessel(s) operating the scheduled departure.
    • shortest: available only if a vessel was provided in the route request.
    • proforma: not available, since multiple potential vessels per leg make fuel consumption inconsistent to compute.

Support endpoints and resources

  • Get routes: use the /v3/routes endpoint to retrieve route snapshots (id) and their details.
  • Explore the list of Supported fields and values.
Language
Credentials
Header
Click Try It! to start a request and see the response here!