Community

We often get the question: what models do you use at Searoutes to compute the carbon emissions of shipments?

You can find a partial answer on our Data Models page, where we've listed all of them, from factor to historical.

However, the complete answer is in the response of our /shipment/v2/report/co2 API. A typical response will look like the following:

{
  "parameters": {},
  "co2e": {},
  "transportChainElements": [
    {
      "type": "leg",
      "mode": "road",
      "from": "...",
      "to": "...",
      "properties": {
        "dataType": "modeled",
        "model": {
          "name": "network-portcalls-schedules" 
        }
      }
    }
  ]
}

The pair of keys dataType: default, model, primary and model are here to indicate what parameters were used in the calculations.

Our models names are a combination of the distance used, the type of routing and the characteristics of the model. Consider the following examples:

Ocean freight movement with carrier name

'type': leg,
'mode': sea,
'carrier_scac': CMDU # CMA CGM 

'dataType': modeled
'model': network-portcalls-schedules # network distance (transhipments), route w portcalls, model based on schedules

Ocean freight movement with past date and vessel name / imo

'type': leg,
'mode': sea,
'datetime_departure': 2024-12-14
'vessel_imo': 9706906 # CMA CGM Zheng He

'dataType': modeled
'model': network-portcalls-ais # network distance (transhipments), route w portcalls, model based on historical ais

Air freight movement with past date and flight number

'type': leg,
'mode': sea,
'from': paris,
'to': toronto,
'datetime_departure': 2025-01-19
'flight_number': AF356

'dataType': modeled
'model': gcd-direct-icao # great circle distance, direct route, icao model

Our /shipment/v2/report/co2 API naturally adapts to the parameters that you've passed in, and selects the ones most relevant to provide you with the most accurate model.

Learn more on the Data Models page, try the endpoint yourself or send us an email at contact@searoutes.com.