Fetch Emissions Data into your Inhouse System

The following endpoint allow to get emissions data for transports that finished tracking.

Details on how Transporeon Visibility calulcates carbon emissions data can be found in the following help center article: https://intercom.help/sixfold/en/articles/5800433-carbon-visibility-methodology

How to

Make an authenticated GET request as shown in the example below:

https://api.test.transporeon.com/rtv/v1/emissions

The response contains a list of transports. For each transport, various emissions related fields are present:

emissions_calculated_at: Timestamp of carbon emissions calculation.
calculation_errors: Details on the error in case the system wasn’t able to calculate the emissions
planned_emissions: TBD
- total_emissions: Accumulated emissions for all legs (is that right?)
- legs: Listing of single legs used for emissions calculation
  - emissions: Details to the emissions for each leg
  - start_location& end_location: Latitude and longitude of leg start- and endlocation
  - distance_km: The distance of the leg in kilometers
  - carriage_parameters: Details on the carriage, such as bio_fuel_shareand carriage_mode_parameters
  - external_costs: Details on the accident_, external_ and emissions_costas well as the total_external_costs in the specified currency
- cargo: Details on the transported cargo, such as weight and volume.
- transport_activity_tonne_kms: TBD
- emissions_intensity_gram_per_tonne_kms: TBD
driven_distance: Driven distance in kilometer?
driven_distance_source: TBD
fuel_based_emissions: Fuel consumption, type and other details.
carbon_data_index: TBD

Example:

{
  "transports": [
    {
      "transport_id": "314159",
      "emissions_calculated_at": "2019-08-24T14:15:22Z",
      "transport_number": "T1234",
      "calculation_errors": [
        {
          "error_type": "DISTANCE",
          "error_code": "TOUR_WEIGHT_OUT_OF_ALLOWED_RANGE",
          "error_message": "Skipping CO2 emissions calculation, weight data invalid, weightInTonnes: 0, main_mode: undefined"
        }
      ],
      "planned_emissions": {
        "total_emissions": {
          "co2_well_to_tank_tonnes": 0,
          "co2_tank_to_wheel_tonnes": 0,
          "co2_well_to_wheel_tonnes": 0
        },
        "legs": [
          {
            "emissions": [
              {
                "type": "CARBON_DIOXIDE",
                "emission_mode": "ROAD",
                "unit": "TONNES",
                "tank_to_wheel": 0,
                "well_to_tank": 0,
                "total": 0
              }
            ],
            "transport_mode": "ROAD",
            "start_location": {
              "lat": 0,
              "lng": 0
            },
            "end_location": {
              "lat": 0,
              "lng": 0
            },
            "type": "PRE_CARRIAGE",
            "carriage_parameters": {
              "bio_fuel_share": 0,
              "carriage_mode_parameters": [
                {
                  "mode": "ROAD",
                  "emission_class": "EuEuro6ac",
                  "empty_run_factor": 0,
                  "ferry_routing": "Normal",
                  "fuel_type": "diesel",
                  "load_factor": 0,
                  "lorry_class": "Class40",
                  "drive_class": "string",
                  "aircraft_type": "string",
                  "sea_ship_type": "string",
                  "inland_ship_type": "string"
                }
              ]
            },
            "distance_km": 0,
            "external_costs": {
              "currency": "Euro",
              "accident_costs": [
                {
                  "transport_mode": "ROAD",
                  "accident_cost_value": 0
                }
              ],
              "noise_costs": [
                {
                  "transport_mode": "ROAD",
                  "noise_costs_value": 0
                }
              ],
              "emission_costs": [
                {
                  "name": "SULFUR_DIOXIDES",
                  "tank_to_wheel": 0,
                  "well_to_tank": 0,
                  "total": 0
                }
              ],
              "total_external_costs": 0
            }
          }
        ],
        "cargo": {
          "container_empty_weight": 0,
          "tons_per_feu": 0,
          "tons_per_teu": 0,
          "unit": "string",
          "volume_weight": "AVERAGE",
          "weight": 0
        },
        "transport_activity_tonne_kms": 0,
        "emissions_intensity_gram_per_tonne_kms": 0
      },
      "driven_distance": 253.4,
      "driven_distance_source": "string",
      "fuel_based_emissions": {
        "accumulated_fuel_consumption_liters": 0,
        "fuel_type": "string",
        "co2_well_to_tank_tonnes": 0,
        "co2_tank_to_wheel_tonnes": 0,
        "co2_well_to_wheel_tonnes": 0,
        "transport_activity_tonne_kms": 0,
        "emissions_intensity_gram_per_tonne_kms": 0
      },
      "carbon_data_index": 0
    }
  ],
  "page_info": {
    "cursor": "c2l4Zm9sZF9hcGlfZXhhbXBsZQ=="
  }
}