Important note : this endpoint will be removed in future versions and be replaced by a new endpoint GET /v3/fuel/statistics.

Compute aggregated fuel consumption statistics for a set of routes.

Notes and considerations

• Route types:
  • shortest → shortest feasible path, considering traffic separation schemes and port entries.
  • historical → reconstructs past voyages around the given departureDate using AIS data.
  • proforma → uses carriers service plans.
  • schedule → uses upcoming carrier vessel departures.
• 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.
  • historical: based on the vessel(s) that performed the voyage.
  • schedule: 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.
• id lifetime: the route id returned in the response, remain valid for a limited period (at least 1 hour), following the same policy as any v3/route sub-resources.

Support endpoints and resources

• Get routes details: use the v3/routes/{id} endpoint using the id returned in the response of the present endpoint.
• Explore the the list of Supported fields and values.