Skip to main content
GET
/
{id}
Get calculation result
curl --request GET \
  --url https://api.terratwin.com/api/v1/transportation/emissions/{id} \
  --header 'x-api-key: <api-key>'
{
  "createdAt": "2026-02-03T09:51:38.473461+00:00",
  "result": {
    "id": "123456789",
    "origin": {
      "type": "PLACE",
      "latitude": 51.503314,
      "longitude": -0.127697
    },
    "destination": {
      "type": "RAIL_YARD",
      "countryCode": "BE",
      "latitude": 50.842691,
      "longitude": 4.380654,
      "address": "L161A"
    },
    "activityDistanceKm": 432.81564963432754,
    "activityTonneKm": 43.281564963432764,
    "transportIntensities": {
      "wttCo2eGramsPerTonneKm": 7.06480567200353,
      "ttwCo2eGramsPerTonneKm": 23.037518111707207,
      "wtwCo2eGramsPerTonneKm": 30.10232378371073
    },
    "transportEmissions": {
      "wttCo2eGrams": 305.77584564684906,
      "ttwCo2eGrams": 997.0998367481144,
      "wtwCo2eGrams": 1302.8756823949632
    },
    "hubIntensities": {
      "co2eGramsPerTonne": 3.8
    },
    "hubEmissions": {
      "co2eGrams": 0.38
    },
    "totalIntensities": {
      "co2eGramsPerTonneKm": 30.111103503213045
    },
    "totalEmissions": {
      "co2eGrams": 1303.2556823949633
    },
    "certificateUrl": "https://www.terratwin.com/certificate/3f34c409-284f-4cc2-baa5-124a08bde490",
    "context": {
      "reportingParty": {
        "name": "Acme Corp",
        "organisationNumber": "12345",
        "Custom value": "Custom reporting party value"
      },
      "reportingTo": {
        "name": "Shipping Inc",
        "address": "100 Example Street, Demo City, DC 10001 Exampleland",
        "Extra information": "Custom reporting to value"
      },
      "consignor": {
        "name": "Apex Distribution",
        "Further details": "Custom consignor value"
      },
      "consignee": {
        "name": "Globex Group",
        "organisationNumber": "54321"
      },
      "movedBy": {
        "name": "Atlas Logistics"
      },
      "transaction": {
        "project": "",
        "agreement": "",
        "incoterms": "DAP Customer Warehouse, Brussels, Belgium — Incoterms® 2020"
      },
      "cargo": {
        "shipmentId": "ABCD-123456789",
        "Supplementary Information": "Additional ccargo details"
      },
      "customStringProperty": "customPropertyValue",
      "customNumericProperty": 42
    },
    "transportChain": [
      {
        "type": "WATER",
        "id": "123456789-01",
        "start": {
          "type": "PLACE",
          "latitude": 51.503314,
          "longitude": -0.127697
        },
        "end": {
          "type": "HARBOR",
          "countryCode": "BE",
          "unLoCode": "BEANR",
          "latitude": 51.27936713324465,
          "longitude": 4.3567657470703125,
          "address": "Antwerp"
        },
        "activityDistanceKm": 358.24702719735023,
        "activityTonneKm": 35.82470271973503,
        "transportIntensities": {
          "wttCo2eGramsPerTonneKm": 6.966414868380875,
          "ttwCo2eGramsPerTonneKm": 27.524003700923917,
          "wtwCo2eGramsPerTonneKm": 34.490418569304786
        },
        "transportEmissions": {
          "wttCo2eGrams": 249.56974168208689,
          "ttwCo2eGrams": 986.0392502424861,
          "wtwCo2eGrams": 1235.6089919245728
        },
        "hubIntensities": {
          "co2eGramsPerTonne": 1.9
        },
        "hubEmissions": {
          "co2eGrams": 0.19
        },
        "totalIntensities": {
          "co2eGramsPerTonneKm": 34.495722172281944
        },
        "totalEmissions": {
          "co2eGrams": 1235.7989919245729
        },
        "context": {
          "additionalInformation": "customWaterLegValue"
        },
        "elements": [
          {
            "vehicle": "ARTICULATED_TRUCK_40000_TO_50000_KG",
            "emissionsStandard": "EURO_6AC",
            "loadFactor": 72,
            "emptyRunning": 30,
            "loadDistribution": "LTL",
            "methodology": "INFRAS_HBEFA_5_1",
            "distanceMeasurementMethod": "SHORTEST_FEASIBLE_DISTANCE",
            "calculationBasis": "MODEL",
            "distanceAdjustmentFactor": "1.05",
            "start": {
              "type": "PLACE",
              "latitude": 51.503314,
              "longitude": -0.127697
            },
            "end": {
              "type": "PLACE",
              "latitude": 51.459472,
              "longitude": 0.340663
            },
            "activityDistanceKm": 44.69842583939949,
            "activityTonneKm": 4.46984258393995,
            "transportIntensities": {
              "wttCo2eGramsPerTonneKm": 18.188259972604925,
              "ttwCo2eGramsPerTonneKm": 55.634499734404805,
              "wtwCo2eGramsPerTonneKm": 73.82275970700972
            },
            "transportEmissions": {
              "wttCo2eGrams": 81.29865895331996,
              "ttwCo2eGrams": 248.67745604903843,
              "wtwCo2eGrams": 329.97611500235837
            },
            "resultsByEnergyType": [
              {
                "energyType": "DIESEL",
                "activityDistanceKm": 44.69842583939949,
                "activityTonneKm": 4.46984258393995,
                "intensities": {
                  "wttCo2eGramsPerTonneKm": 18.188259972604925,
                  "ttwCo2eGramsPerTonneKm": 55.634499734404805,
                  "wtwCo2eGramsPerTonneKm": 73.82275970700974
                },
                "emissions": {
                  "wttCo2eGrams": 81.29865895331996,
                  "ttwCo2eGrams": 248.67745604903843,
                  "wtwCo2eGrams": 329.97611500235837
                },
                "resultsByEnergySource": [
                  {
                    "energySource": "BIODIESEL_FROM_RAPESEED",
                    "factorReference": "ECOTRANSIT_4_0_EUROPE_BIOGENIC_FUEL_EMISSION_FACTORS",
                    "emissions": {
                      "wttCo2eGrams": 4.729108573738301,
                      "ttwCo2eGrams": 0.11573345876659132,
                      "wtwCo2eGrams": 4.844842032504893
                    }
                  },
                  {
                    "energySource": "BIODIESEL_FROM_UCO",
                    "factorReference": "ECOTRANSIT_4_0_EUROPE_BIOGENIC_FUEL_EMISSION_FACTORS",
                    "emissions": {
                      "wttCo2eGrams": 1.2690772375095185,
                      "ttwCo2eGrams": 0.09258676701327305,
                      "wtwCo2eGrams": 1.3616640045227915
                    }
                  },
                  {
                    "energySource": "BIODIESEL_FROM_SOYBEAN",
                    "factorReference": "ECOTRANSIT_4_0_EUROPE_BIOGENIC_FUEL_EMISSION_FACTORS",
                    "emissions": {
                      "wttCo2eGrams": 0.8260974470580831,
                      "ttwCo2eGrams": 0.023146691753318262,
                      "wtwCo2eGrams": 0.8492441388114014
                    }
                  },
                  {
                    "energySource": "FOSSIL_DIESEL",
                    "factorReference": "SFC_GLEC_3_2_EUROPE_EMISSION_FACTORS",
                    "emissions": {
                      "wttCo2eGrams": 74.47437569501406,
                      "ttwCo2eGrams": 248.44598913150526,
                      "wtwCo2eGrams": 322.9203648265193
                    }
                  }
                ]
              }
            ],
            "type": "ROAD"
          },
          {
            "hubType": "MARITIME_TERMINAL",
            "activityTonnes": 0.1,
            "intensities": {
              "co2eGramsPerTonne": 1.9000000000000001
            },
            "emissions": {
              "co2eGrams": 0.19
            },
            "methodology": "SFC_GLEC_FRAMEWORK_3_2",
            "calculationBasis": "DEFAULT_FACTORS",
            "type": "HUB"
          },
          {
            "vehicle": "CONTAINER",
            "capacityBand": "POST_PANAMAX",
            "containerType": "TWENTY_FOOT_CONTAINER",
            "methodology": "SFC_GLEC_FRAMEWORK_3_2",
            "distanceMeasurementMethod": "SHORTEST_FEASIBLE_DISTANCE",
            "distanceAdjustmentFactor": "1.15",
            "calculationBasis": "DEFAULT_FACTORS",
            "start": {
              "type": "HARBOR",
              "countryCode": "GB",
              "unLoCode": "GBTIL",
              "latitude": 51.459502138725945,
              "longitude": 0.3407907485961914,
              "address": "Tilbury"
            },
            "end": {
              "type": "HARBOR",
              "countryCode": "BE",
              "unLoCode": "BEANR",
              "latitude": 51.27936713324465,
              "longitude": 4.3567657470703125,
              "address": "Antwerp"
            },
            "activityDistanceKm": 313.54860135795076,
            "activityTonneKm": 31.35486013579508,
            "transportIntensities": {
              "wttCo2eGramsPerTonneKm": 5.366666666666667,
              "ttwCo2eGramsPerTonneKm": 23.516666666666666,
              "wtwCo2eGramsPerTonneKm": 28.883333333333336
            },
            "transportEmissions": {
              "wttCo2eGrams": 168.27108272876694,
              "ttwCo2eGrams": 737.3617941934476,
              "wtwCo2eGrams": 905.6328769222146
            },
            "resultsByEnergyType": [
              {
                "energyType": "VLSFO",
                "activityDistanceKm": 313.54860135795076,
                "activityTonneKm": 31.35486013579508,
                "intensities": {
                  "wttCo2eGramsPerTonneKm": 5.366666666666667,
                  "ttwCo2eGramsPerTonneKm": 23.516666666666666,
                  "wtwCo2eGramsPerTonneKm": 28.883333333333333
                },
                "emissions": {
                  "wttCo2eGrams": 168.27108272876694,
                  "ttwCo2eGrams": 737.3617941934476,
                  "wtwCo2eGrams": 905.6328769222146
                },
                "resultsByEnergySource": [
                  {
                    "energySource": "FOSSIL_VLSFO",
                    "factorReference": "SFC_GLEC_3_2_MARINE_EMISSION_FACTORS",
                    "emissions": {
                      "wttCo2eGrams": 168.27108272876694,
                      "ttwCo2eGrams": 737.3617941934476,
                      "wtwCo2eGrams": 905.6328769222146
                    }
                  }
                ]
              }
            ],
            "type": "WATER"
          }
        ]
      },
      {
        "hubType": "MARITIME_TERMINAL",
        "activityTonnes": 0.1,
        "intensities": {
          "co2eGramsPerTonne": 1.9000000000000001
        },
        "emissions": {
          "co2eGrams": 0.19
        },
        "methodology": "SFC_GLEC_FRAMEWORK_3_2",
        "calculationBasis": "DEFAULT_FACTORS",
        "type": "HUB"
      },
      {
        "type": "RAIL",
        "id": "123456789-02",
        "start": {
          "type": "RAIL_YARD",
          "countryCode": "BE",
          "latitude": 51.279002,
          "longitude": 4.356769,
          "address": ""
        },
        "end": {
          "type": "RAIL_YARD",
          "countryCode": "BE",
          "latitude": 50.842691,
          "longitude": 4.380654,
          "address": "L161A"
        },
        "activityDistanceKm": 74.56862243697734,
        "activityTonneKm": 7.456862243697734,
        "transportIntensities": {
          "wttCo2eGramsPerTonneKm": 7.537500644090015,
          "ttwCo2eGramsPerTonneKm": 1.4832762285472343,
          "wtwCo2eGramsPerTonneKm": 9.02077687263725
        },
        "transportEmissions": {
          "wttCo2eGrams": 56.206103964762185,
          "ttwCo2eGrams": 11.060586505628242,
          "wtwCo2eGrams": 67.26669047039043
        },
        "hubIntensities": {
          "co2eGramsPerTonne": 0
        },
        "hubEmissions": {
          "co2eGrams": 0
        },
        "totalIntensities": {
          "co2eGramsPerTonneKm": 9.02077687263725
        },
        "totalEmissions": {
          "co2eGrams": 67.26669047039043
        },
        "context": {
          "customProperty": "customRailLegValue"
        },
        "elements": [
          {
            "vehicle": "AVERAGE_TRAIN",
            "methodology": "ECOTRANSIT_RAIL_4_0",
            "distanceMeasurementMethod": "SHORTEST_FEASIBLE_DISTANCE",
            "calculationBasis": "MODEL",
            "distanceAdjustmentFactor": "1.0",
            "start": {
              "type": "RAIL_YARD",
              "countryCode": "BE",
              "latitude": 51.279002,
              "longitude": 4.356769,
              "address": ""
            },
            "end": {
              "type": "RAIL_YARD",
              "countryCode": "BE",
              "latitude": 50.842691,
              "longitude": 4.380654,
              "address": "L161A"
            },
            "activityDistanceKm": 74.56862243697734,
            "activityTonneKm": 7.456862243697734,
            "transportIntensities": {
              "wttCo2eGramsPerTonneKm": 7.537500644090015,
              "ttwCo2eGramsPerTonneKm": 1.4832762285472343,
              "wtwCo2eGramsPerTonneKm": 9.02077687263725
            },
            "transportEmissions": {
              "wttCo2eGrams": 56.206103964762185,
              "ttwCo2eGrams": 11.060586505628242,
              "wtwCo2eGrams": 67.26669047039043
            },
            "resultsByEnergyType": [
              {
                "energyType": "ELECTRICITY",
                "activityDistanceKm": 70.71537321805414,
                "activityTonneKm": 7.0715373218054145,
                "intensities": {
                  "wttCo2eGramsPerTonneKm": 7.479360000000002,
                  "ttwCo2eGramsPerTonneKm": 0,
                  "wtwCo2eGramsPerTonneKm": 7.479360000000002
                },
                "emissions": {
                  "wttCo2eGrams": 52.89057338321856,
                  "ttwCo2eGrams": 0,
                  "wtwCo2eGrams": 52.89057338321856
                },
                "resultsByEnergySource": [
                  {
                    "energySource": "ELECTRICAL_GRID",
                    "factorReference": "ECOTRANSIT_4_0_MEDIUM_VOLTAGE_EMISSION_FACTORS",
                    "emissions": {
                      "wttCo2eGrams": 52.89057338321856,
                      "ttwCo2eGrams": 0,
                      "wtwCo2eGrams": 52.89057338321856
                    }
                  }
                ]
              },
              {
                "energyType": "DIESEL",
                "activityDistanceKm": 3.8532492189231973,
                "activityTonneKm": 0.38532492189231976,
                "intensities": {
                  "wttCo2eGramsPerTonneKm": 8.604505945945949,
                  "ttwCo2eGramsPerTonneKm": 28.704570810810825,
                  "wtwCo2eGramsPerTonneKm": 37.309076756756774
                },
                "emissions": {
                  "wttCo2eGrams": 3.3155305815436233,
                  "ttwCo2eGrams": 11.060586505628242,
                  "wtwCo2eGrams": 14.376117087171865
                },
                "resultsByEnergySource": [
                  {
                    "energySource": "FOSSIL_DIESEL",
                    "factorReference": "SFC_GLEC_3_2_EUROPE_EMISSION_FACTORS",
                    "emissions": {
                      "wttCo2eGrams": 3.3155305815436233,
                      "ttwCo2eGrams": 11.060586505628242,
                      "wtwCo2eGrams": 14.376117087171865
                    }
                  }
                ]
              }
            ],
            "type": "RAIL"
          }
        ]
      }
    ],
    "creditCost": 3
  }
}

Authorizations

​
x-api-key
string
header
required

API key for authenticating requests. Include this header in all calls.

Path Parameters

​
id
string
required

ID of the emissions calculation to retrieve.

Response

Returns the stored emissions calculation for the supplied ID. The response includes the calculation creation date-time and the full calculation result.

​
createdAt
string<date-time>
required

The date and time when the calculation was stored, in ISO 8601 format.

​
result
object
required