post https://api.searoutes.com/v3/fuel
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 routeid
remains valid for a limited period (at least 1 hour), following the same policy as anyv3/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.