Transport Types

const options = {
  method: 'GET',
  headers: {
    'x-api-key': '<x-api-key>',
    'x-organization-id': '<x-organization-id>',
    'x-user-id': '<x-user-id>'
  }
};

fetch('https://api.dcycle.io/api/v1/logistics/tocs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.dcycle.io/api/v1/logistics/tocs"

headers = {
    "x-api-key": "<x-api-key>",
    "x-organization-id": "<x-organization-id>",
    "x-user-id": "<x-user-id>"
}

response = requests.get(url, headers=headers)

print(response.text)

curl --request GET \
  --url https://api.dcycle.io/api/v1/logistics/tocs \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-organization-id: <x-organization-id>' \
  --header 'x-user-id: <x-user-id>'

{
  "toc_id": "<string>",
  "name": "<string>",
  "category": "<string>",
  "vehicle_type": "<string>",
  "fuel_type": "<string>",
  "emission_factor": 123,
  "capacity": "<string>"
}

GET

api

logistics

tocs

Transport Types

const options = {
  method: 'GET',
  headers: {
    'x-api-key': '<x-api-key>',
    'x-organization-id': '<x-organization-id>',
    'x-user-id': '<x-user-id>'
  }
};

fetch('https://api.dcycle.io/api/v1/logistics/tocs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.dcycle.io/api/v1/logistics/tocs"

headers = {
    "x-api-key": "<x-api-key>",
    "x-organization-id": "<x-organization-id>",
    "x-user-id": "<x-user-id>"
}

response = requests.get(url, headers=headers)

print(response.text)

curl --request GET \
  --url https://api.dcycle.io/api/v1/logistics/tocs \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-organization-id: <x-organization-id>' \
  --header 'x-user-id: <x-user-id>'

{
  "toc_id": "<string>",
  "name": "<string>",
  "category": "<string>",
  "vehicle_type": "<string>",
  "fuel_type": "<string>",
  "emission_factor": 123,
  "capacity": "<string>"
}

Transport Types (TOCs)

Get the complete list of supported transport types (Transport Operation Categories) with their emission factors.

TOC (Transport Operation Category) is the ISO 14083 standard term for classifying transport modes by vehicle type, fuel, and capacity.

Request

Headers

string

required

Your API key for authenticationExample: sk_live_1234567890abcdef

string

required

Your organization UUIDExample: ff4adcc7-8172-45fe-9cf1-e90a6de53aa9

string

required

Your user UUIDExample: a1b2c3d4-e5f6-7890-abcd-ef1234567890

This endpoint requires no parameters.

Response

Returns an array of objects with information about each transport type:

string

Unique identifier for the transport type (use it in other endpoints)

string

Descriptive name of the transport type

string

General category: road, rail, air, sea

string

Vehicle type: van, truck, train, airplane, ship

string

Fuel type: diesel, electric, petrol, lng, aviation_fuel, marine_fuel

number

Emission factor in kg CO2e per ton-km

string

Typical vehicle capacity

Example

curl -X GET "https://api.dcycle.io/api/v1/logistics/tocs" \
  -H "Authorization: Bearer ${DCYCLE_API_KEY}" \
  -H "x-organization-id: ${DCYCLE_ORG_ID}" \
  -H "x-user-id: ${DCYCLE_USER_ID}"

import requests
import os

api_key = os.getenv("DCYCLE_API_KEY")
org_id = os.getenv("DCYCLE_ORG_ID")

headers = {
    "Authorization": f"Bearer {api_key}",
    "x-organization-id": org_id,
    "x-user-id": user_id
}

response = requests.get(
    "https://api.dcycle.io/api/v1/logistics/tocs",
    headers=headers
)

tocs = response.json()
for toc in tocs:
    print(f"{toc['toc_id']}: {toc['name']} ({toc['emission_factor']} kg CO2e/ton-km)")

const axios = require('axios');

const apiKey = process.env.DCYCLE_API_KEY;
const orgId = process.env.DCYCLE_ORG_ID;

const headers = {
  'Authorization': `Bearer ${apiKey}`,
  'x-organization-id': orgId,
  'x-user-id': userId
};

axios.get(
  'https://api.dcycle.io/api/v1/logistics/tocs',
  { headers }
)
.then(response => {
  response.data.forEach(toc => {
    console.log(`${toc.toc_id}: ${toc.name} (${toc.emission_factor} kg CO2e/ton-km)`);
  });
})
.catch(error => console.error(error));

Successful Response

[
  {
    "toc_id": "van_diesel",
    "name": "Diesel Van",
    "category": "road",
    "vehicle_type": "van",
    "fuel_type": "diesel",
    "emission_factor": 0.000396,
    "capacity": "< 3.5 ton"
  },
  {
    "toc_id": "van_electric",
    "name": "Electric Van",
    "category": "road",
    "vehicle_type": "van",
    "fuel_type": "electric",
    "emission_factor": 0.000098,
    "capacity": "< 3.5 ton"
  },
  {
    "toc_id": "truck_diesel",
    "name": "Diesel Rigid Truck",
    "category": "road",
    "vehicle_type": "truck",
    "fuel_type": "diesel",
    "emission_factor": 0.000512,
    "capacity": "3.5 - 7.5 ton"
  },
  {
    "toc_id": "truck_articulated",
    "name": "Articulated Truck",
    "category": "road",
    "vehicle_type": "truck",
    "fuel_type": "diesel",
    "emission_factor": 0.000673,
    "capacity": "> 33 ton"
  },
  {
    "toc_id": "rail_freight",
    "name": "Freight Train",
    "category": "rail",
    "vehicle_type": "train",
    "fuel_type": "electric",
    "emission_factor": 0.000025,
    "capacity": "High capacity"
  },
  {
    "toc_id": "air_freight",
    "name": "Cargo Airplane",
    "category": "air",
    "vehicle_type": "airplane",
    "fuel_type": "aviation_fuel",
    "emission_factor": 0.00245,
    "capacity": "Variable"
  },
  {
    "toc_id": "sea_container",
    "name": "Container Ship",
    "category": "sea",
    "vehicle_type": "ship",
    "fuel_type": "marine_fuel",
    "emission_factor": 0.000012,
    "capacity": "Very high capacity"
  }
]

Use Cases

Transport Type Selector

Populate a selector in your UI with available types:

def get_transport_options():
    """Get transport options for selector"""
    tocs = get_tocs()

    # Group by category
    by_category = {}
    for toc in tocs:
        category = toc['category']
        if category not in by_category:
            by_category[category] = []
        by_category[category].append({
            'value': toc['toc_id'],
            'label': toc['name'],
            'emissions': toc['emission_factor']
        })

    return by_category

# Result:
# {
#   "road": [{"value": "van_diesel", "label": "Diesel Van", ...}],
#   "rail": [...],
#   "air": [...],
#   "sea": [...]
# }

Emissions Comparator

Compare emission factors between different modes:

def compare_transport_modes():
    """Compare emissions by transport mode"""
    tocs = get_tocs()

    # Sort by emission factor (lowest to highest)
    sorted_tocs = sorted(tocs, key=lambda x: x['emission_factor'])

    print("🌿 Transport modes sorted by emissions (lowest to highest):\n")

    for i, toc in enumerate(sorted_tocs, 1):
        print(f"{i}. {toc['name']}")
        print(f"   Factor: {toc['emission_factor']} kg CO2e/ton-km")
        print(f"   Category: {toc['category']}\n")

# Output:
# 1. Container Ship
#    Factor: 0.000012 kg CO2e/ton-km
#    Category: sea
#
# 2. Freight Train
#    Factor: 0.000025 kg CO2e/ton-km
#    Category: rail
# ...

Impact Calculator

Calculate the impact of switching transport modes:

def calculate_mode_switch_impact(distance_km, load_kg, from_toc, to_toc):
    """Calculate impact of switching transport modes"""
    tocs = {toc['toc_id']: toc for toc in get_tocs()}

    load_ton = load_kg / 1000
    ton_km = distance_km * load_ton

    # Emissions with current mode
    current_emissions = ton_km * tocs[from_toc]['emission_factor']

    # Emissions with alternative mode
    new_emissions = ton_km * tocs[to_toc]['emission_factor']

    # Savings
    savings = current_emissions - new_emissions
    savings_percentage = (savings / current_emissions) * 100

    return {
        'current_mode': tocs[from_toc]['name'],
        'new_mode': tocs[to_toc]['name'],
        'current_emissions': current_emissions,
        'new_emissions': new_emissions,
        'savings_kg': savings,
        'savings_percentage': savings_percentage
    }

# Example: Switch from diesel truck to train
impact = calculate_mode_switch_impact(
    distance_km=500,
    load_kg=5000,
    from_toc='truck_diesel',
    to_toc='rail_freight'
)

print(f"Switching from {impact['current_mode']} to {impact['new_mode']}:")
print(f"Savings: {impact['savings_kg']:.2f} kg CO2e ({impact['savings_percentage']:.1f}%)")

Data Validation

Validate that a TOC exists before calculating:

def validate_toc(toc_id):
    """Validate that a TOC exists"""
    tocs = get_tocs()
    valid_toc_ids = [toc['toc_id'] for toc in tocs]

    if toc_id not in valid_toc_ids:
        raise ValueError(
            f"TOC '{toc_id}' not valid. "
            f"Valid options: {', '.join(valid_toc_ids)}"
        )

    return True

Filtering by Category

While the endpoint doesn’t support filters directly, you can filter in your code:

# Get only road transport
road_tocs = [toc for toc in get_tocs() if toc['category'] == 'road']

# Get only electric vehicles
electric_tocs = [toc for toc in get_tocs() if toc['fuel_type'] == 'electric']

# Get TOCs with low emissions (< 0.0001 kg/ton-km)
low_emission_tocs = [toc for toc in get_tocs() if toc['emission_factor'] < 0.0001]

Emission Factors

Emission factors are based on:

GLEC Framework - Global Logistics Emissions Council
EN 16258 - European standard for transport emissions
DEFRA - UK Government conversion factors
EPA - US Environmental Protection Agency

Emission factors are updated annually to reflect the latest methodologies and available data.

Calculate Shipment

Use a TOC to calculate emissions

Upload CSV

Specify TOCs in your CSV

Introduction

Logistics

Facilities

Vehicles

Purchases

Wastes

Reference Data

Custom Emission Factors

Custom Emission Groups

Transport Types

Transport Types (TOCs)

Request

Headers

Response

Example

Successful Response

Use Cases

Transport Type Selector

Emissions Comparator

Impact Calculator

Data Validation

Filtering by Category

Emission Factors

Calculate Shipment

Upload CSV

​Transport Types (TOCs)

​Request

​Headers

​Response

​Example

​Successful Response

​Use Cases

​Transport Type Selector

​Emissions Comparator

​Impact Calculator

​Data Validation

​Filtering by Category

​Emission Factors

​Related Endpoints

Calculate Shipment

Upload CSV

Transport Types (TOCs)

Request

Headers

Response

Example

Successful Response

Use Cases

Transport Type Selector

Emissions Comparator

Impact Calculator

Data Validation

Filtering by Category

Emission Factors

Related Endpoints