Bus: DEFRA 🇬🇧

Calculate bus and coach travel emissions with the UK government's DEFRA conversion factors, by bus category and energy scope, pinned to a Conversion Factors year if you need to.

type busmethodology DEFRASupports audit mode

About the methodology

DEFRA's methodology for the carbon footprint of bus travel is based on standardised emission factors published by the UK government. These factors are derived from extensive national data sources and give a reliable basis for estimating greenhouse gas emissions from different types of bus transport.

The methodology covers several bus categories, including local buses inside and outside London and long-distance coaches. Emissions are calculated from factors such as fuel consumption, average occupancy and energy efficiency. DEFRA supports two energy scopes: tank-to-wheel (TTW) and well-to-wheel (WTW). WTW is the default, for a more comprehensive lifecycle assessment.

Building on DEFRA's established reporting framework, businesses and policymakers get consistent, transparent carbon accounting for bus travel, aligned with UK environmental reporting regulations and sustainability strategies.

Versions

Use methodology_version to pin the DEFRA Conversion Factors year (for example "2024"). If you omit it, SQUAKE automatically applies the latest supported year. Pin a specific year for reproducibility and auditability.

Sample requests

Send a quote before booking, then repeat the call with audit set to true once the booking is final. The body is otherwise identical.

{
  "expand": ["items"],
  "items": [{
    "audit": false,
    "type": "bus",
    "external_reference": "test_1",
    "origin": "London",
    "destination": "Bristol",
    "bus_type": "coach",
    "number_of_travelers": 3,
    "energy_scope": "wtw",
    "methodology": "DEFRA",
    "methodology_version": "2024"
  }]
}

audit_for is optional

Pass the ID of an auditable entity when you calculate on behalf of that entity. Otherwise, leave it out.

Defaults

FieldDefaultApplies when
bus_typeaverage_local_busNo bus_type is sent
energy_scopewtwNo energy_scope is sent
methodology_versionLatest supported DEFRA yearNo methodology_version is sent

Request fields

typestringrequired

bus

methodologystringrequired

DEFRA

methodology_versionstring

DEFRA Conversion Factors year, for example 2024. If omitted, SQUAKE uses the latest supported year.

external_referencestring

Correlates the response to the request, up to 128 characters.

number_of_travelersinteger

Minimum 1. Defaults to 1.

originstring

Postal, IATA/ICAO, UN/LOCODE or lat,lon. See Origin and destination formats.

destinationstring

Same formats as origin.

distance_in_kmnumber

If present, overrides origin and destination.

bus_typeenum

local_bus_not_london, local_bus_london, average_local_bus (default) or coach.

energy_scopeenum

wtw (default), well-to-wheel, or ttw, tank-to-wheel.

auditboolean

Set to true to create immutable audit records for finalised calculations. Must be enabled for your account.

See every field of POST /v2/calculations in the API reference

Origin and destination formats

SQUAKE tries to resolve origin and destination whatever their format. Ideally, use:

  • Addresses: the Post standard.
  • Airports: an IATA/ICAO code (regex ^[A-Z]{3,4}$, for example MUC).
  • Ports and trade locations: a UN/LOCODE (regex ^[A-Z]{2}\W?[A-Z2-9]{3}$, for example DEHAM).
  • Coordinates: latitude and longitude (regex ^[-+]?\d{1,3}\.\d{1,10}\s?,\s?[-+]?\d{1,3}\.\d{1,10}$, for example +40.712,-74.006).

Provider and stop codes for buses

You can also reference bus stops or stations with provider-prefixed stop IDs, in the format <provider>:<stop_id> (for example flixbus:2006). Common provider prefixes: flixbus, distribusion, busbud.

Fallback

If a value can't be resolved, SQUAKE falls back to generic (non-journey-specific) DEFRA bus factors.

{
  "type": "bus",
  "methodology": "DEFRA",
  "origin": "flixbus:london_victoria",
  "destination": "flixbus:bristol_bond_st",
  "bus_type": "coach",
  "number_of_travelers": 1,
  "energy_scope": "wtw",
  "methodology_version": "2024"
}

Sample response

200 OKapplication/json
{
  "carbon_quantity": 15240,
  "carbon_unit": "gram",
  "items": [{
    "carbon_quantity": 15240,
    "carbon_unit": "gram",
    "external_reference": "test_1",
    "type": "bus",
    "methodology": "DEFRA",
    "methodology_version": "2024",
    "bus_type": "coach",
    "energy_scope": "wtw",
    "distance": 190.0,
    "distance_unit": "kilometer"
  }]
}

Bibliography

UK Government: Greenhouse Gas Emissions: Research & Statistics.

On this page

POST/v2/calculations

Run this request against the sandbox with your test key.

Open in API reference