Get fuel consumption (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.

Compute fuel consumption for an order on a route or shipment. This endpoint uses the route id retrieved from /v3/routes, or the shipment id from /v3/shipments. The standard order of 1 dry container of 20 feet is represented by the id "order_std20gp".

Notes and considerations

• id lifetime: the route and shipment ids remain valid for a limited period (at least 1 hour) during the beta phase.
• 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.