# EcoFreight — Freight CO2 Emissions API

> EcoFreight provides a REST API for calculating CO2 emissions from freight transport. It supports road, sea, rail, and air transport modes and returns Well-to-Wheel (WTW), Tank-to-Wheel (TTW), and Well-to-Tank (WTT) emission breakdowns.

## What it does

EcoFreight calculates carbon emissions for freight shipments. You send an origin, destination, cargo weight, and transport mode — and get back CO2 emissions in kilograms, distance, and methodology references. Response time is under 50ms.

## API

- Base URL: https://api.ecofreight.co/api/v1
- Authentication: Bearer token (API key from dashboard)
- Main endpoint: POST /calculate

### Request example

```json
{
  "origin": { "city": "Shanghai", "country": "CN", "coordinates": { "lat": 31.2, "lng": 121.5 } },
  "destination": { "city": "Rotterdam", "country": "NL", "coordinates": { "lat": 51.9, "lng": 4.5 } },
  "cargo": { "weight": 21000, "type": "general" },
  "transport_mode": "sea",
  "vessel_type": "container_ship_8000_teu_plus"
}
```

### Response example

```json
{
  "emissions": {
    "total": 3842.7,
    "wtw": 3842.7,
    "ttw": 3267.3,
    "wtt": 575.4
  },
  "calculation": {
    "distance": 19550,
    "activity": 410550,
    "emission_factor": {
      "source": "GLEC Framework v3.2",
      "quality": "secondary"
    }
  },
  "methodology": "ISO 14083:2023",
  "calculation_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
```

## Transport modes

- **Road**: Trucks (heavy 16t+, medium 7.5-16t, light <7.5t, electric)
- **Sea**: Container ships (3000-8000 TEU, 8000+ TEU), bulk carriers, tankers
- **Rail**: Diesel freight, electric freight
- **Air**: Dedicated cargo, belly cargo

## Methodology

- Emission factors: GLEC Framework v3.2 (Global Logistics Emissions Council)
- Standard: ISO 14083:2023
- Emission breakdowns: WTW (total lifecycle), TTW (fuel combustion), WTT (fuel production)
- Data quality tiers: primary (measured), secondary (modeled), default (averages)

## Pricing

- Free: 500 API calls/month, no credit card required
- Pro: $49/month for 10,000 calls
- Enterprise: Custom pricing, unlimited calls

## Links

- Website: https://ecofreight.co
- API docs: https://ecofreight.co/docs
- Calculator: https://ecofreight.co/calculator
- Methodology: https://ecofreight.co/methodology
- Contact: hello@ecofreight.co

## Use cases

- 3PL & freight forwarders: carbon-neutral shipping options
- E-commerce: display carbon footprint at checkout
- Supply chain / ESG: scope 3 emissions reporting
- Fleet management: route optimization for lower emissions
- TMS/ERP integration: automated emission tracking
- Carbon accounting & offset platforms