Compute ETS and related costs (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 ETS emissions, estimated carbon cost, and surcharges for your shipment or for an order on a given route.
This endpoint compares the carbon cost derived from the EU ETS scheme against either:

• user-provided surcharges (surchargePerTeu)
• or Searoutes’ own baseline surcharges per carrier and trade lane.

Notes and considerations

• id lifetime: the route and shipment ids remain valid for a limited period (at least 1 hour) during the beta phase.
• Carrier: the surcharge applied is retrieved from the route based on the carrier provided when querying a route.
• coverage: the ETS coverage ratio reflects the share of voyage emissions under EU ETS jurisdiction.
• complianceFactor: the compliance factor in effect at the shipment date.
• carbonPrice: average price as per the carbon market price.
• Surcharges: the ETS surcharge used in the computation can come from two possible sources.
  • If the user provides a surchargePerTeu value, this input is used directly to calculate the pricingGap and extraSurcharge fields, showing how the user’s surcharge compares to the estimated ETS carbon cost.
  • If no surcharge is provided, Searoutes checks its internal reference table of public carrier surcharges, and applies it to the computation. The source field is either set to public or user_input in the response, allowing users to identify which source of surcharge was applied.
    If no user input or public surcharge is available, the computation still returns ETS cost values, but the surchargePerTeu and pricingGapfield are left null.
    In all cases, the ETS coverage, carbon price, and compliance factor are returned.

Support endpoints and resources

• Get routes: use the /v3/routes endpoint to retrieve route snapshots (id) and their details.
• Understand our methodology