SQUAKE Integration Docs
  • ๐ŸƒOverview
  • โœ‰๏ธContact form
  • โš ๏ธIncident form
  • ๐Ÿ—„๏ธCalculation API Examples
    • ๐ŸŒTravel
      • ๐Ÿ›ŒAccommodation
        • Accommodation: SQUAKE
      • ๐ŸšŒBus
        • Bus: SQUAKE
        • Bus: DEFRA ๐Ÿ‡ฌ๐Ÿ‡ง
      • ๐Ÿš—Car
        • Car: ACRISS
        • Car: DEFRA ๐Ÿ‡ฌ๐Ÿ‡ง
        • Car: EEA ๐Ÿ‡ช๐Ÿ‡บ
        • Car: EPA ๐Ÿ‡บ๐Ÿ‡ธ
      • ๐ŸคEvent
        • Event: HCMI & CHSB
      • โ›ด๏ธFerry
        • Ferry: ADEME ๐Ÿ‡ซ๐Ÿ‡ท
      • โœˆ๏ธFlight
        • Flight: ADEME ๐Ÿ‡ซ๐Ÿ‡ท
        • Flight: Base Empreinte ๐Ÿ‡ซ๐Ÿ‡ท
        • Flight: CO2 emissiefactoren ๐Ÿ‡ณ๐Ÿ‡ฑ
        • Flight: DEFRA ๐Ÿ‡ฌ๐Ÿ‡ง
        • Flight: EPA ๐Ÿ‡บ๐Ÿ‡ธ
        • Flight: GATE4
        • Flight: ICAO
        • Flight: TIM
        • Flight: TU Chalmers ๐Ÿ‡ธ๐Ÿ‡ช
      • ๐ŸจHotel
        • Hotel: DEFRA ๐Ÿ‡ฌ๐Ÿ‡ง
        • Hotel: HCMI & CHSB
        • Hotel: SQUAKE
      • ๐Ÿš†Train
        • Train: ADEME ๐Ÿ‡ซ๐Ÿ‡ท
        • Train: Base Empreinte ๐Ÿ‡ซ๐Ÿ‡ท
        • Train: CO2-emissiefactoren ๐Ÿ‡ณ๐Ÿ‡ฑ
        • Train: DEFRA ๐Ÿ‡ฌ๐Ÿ‡ง
        • Train: SQUAKE
    • ๐Ÿ“ฆLogistics
      • โœˆ๏ธAir Freight
        • Air Freight: DIN EN 16258
        • Air Freight: GLEC
      • ๐Ÿ›ฅ๏ธInland Waterways
        • Inland Waterways: GLEC
      • ๐ŸšงLogistics Site
        • Logistics Site: GLEC
      • ๐ŸšˆRail Freight
        • Rail Freight: DIN EN 16258
        • Rail Freight: ECTA
        • Rail Freight: GLEC
      • ๐ŸššRoad Freight
        • Road Freight: DIN EN 16258
        • Road Freight: GLEC
      • ๐ŸšขSea Freight
        • Road Freight: Clean Cargo
        • Road Freight: DIN EN 16258
        • Road Freight: EMSA ๐Ÿ‡ช๐Ÿ‡บ
        • Road Freight: GLEC
      • ๐Ÿš›Van
        • Van: EEA ๐Ÿ‡ช๐Ÿ‡บ
  • ๐Ÿ†•Notable Changes
    • ๐Ÿ“ŠCalculation Changes
      • Events according to HCMI - 2024 updates
      • Train according to CO2 emissiefactoren - energy scope inclusion
      • Train: SQUAKE - April 2025 Update
      • Bus & Train According to DEFRA are Now Available
      • Base Empreinte for Flights and Trains Now Live
      • TIM Transition to Version 2.0
      • TIM & DEFRA: Distance Changes
      • Airline Code Support Update - December 2024
      • GLEC v3.1
      • Car: DEFRA is Now Available
      • Hotel: DEFRA is Now Available
      • Hotel: HCMI - 2024 Updates
      • Accommodation - September 2024 Updates
      • Bus: SQUAKE - September 2024 Update
      • Flight: DEFRA - July 2024 Update
      • GATE4 Methodology is Now Available
      • GLEC, ECTA, and CLEAN-CARGO November 2023 Update
      • Flight: ICAO v13 - July 2024 Update
      • TIM v1.3
      • Train: SQUAKE - August 2024 Update
  • ๐Ÿ’กUse Cases
    • Fulfillment with API
    • Fulfillment with Self-Checkout
    • Webhooks
    • Webhooks API Reference
  • ๐Ÿ•ต๏ธAudits
    • Retrieve the list of Audit logs
    • Retrieve a specific Audit log
  • ๐Ÿง‘โ€๐Ÿ’ปMigration Guide
    • From v1 to v2
  • โ“Sustainability FAQs
Powered by GitBook
On this page
  • High-Level Description:
  • Sample API Request
  • API request items
  • Sample API Response
  • Bibliography

Was this helpful?

  1. Calculation API Examples
  2. Travel
  3. Flight

Flight: Base Empreinte ๐Ÿ‡ซ๐Ÿ‡ท

PreviousFlight: ADEME ๐Ÿ‡ซ๐Ÿ‡ทNextFlight: CO2 emissiefactoren ๐Ÿ‡ณ๐Ÿ‡ฑ

Last updated 1 month ago

Was this helpful?

High-Level Description:

Base Empreinte, managed by ADEME, is a comprehensive environmental impact database combining data from Base Carbone and Base IMPACTS. For air travel, Base Empreinteยฎ offers emissions data that reflect aircraft size, fuel type, and other parameters crucial for accurate carbon footprint assessments.

The methodology considers the radiative forcing index (RFI) to account for the broader climate impact of aviation emissions beyond CO2. This ensures that businesses and travelers receive comprehensive environmental insights into their air travel.

Sample API Request

{
  "expand": [
    "items"
  ],
  "items": [
    {
      "type": "flight",
      "methodology": "BASE-EMPREINTE",
      "external_reference": "test_1",
      "number_of_travelers": 1,
      "origin": "FRA",
      "destination": "JFK",
      "aircraft_size": "under_220_seats",
      "radiative_forcing_index": true
    }
  ]
}

API request items

  • "type": "flight" (required)

  • "methodology": "BASE-EMPREINTE" (required)

  • "external_reference": A unique identifier that helps you link the resulting emissions to the requested item. Especially useful if multiple items are requested since SQUAKE cannot guarantee to keep the same order. The maximum length is 128 characters.

  • "number_of_travelers": Minimum value is 1. The default value is 1.

  • "origin": SQUAKE will try to resolve the origin/destination regardless of its format. Ideally, for addresses use the Post standard, for airports use IATA/ICAO code (format: ^[A-Z]{3,4}$, e.g. "MUC"), for other locations used in trade and transportation use UN/LOCODE codes (format: ^[A-Z]{2}\W?[A-Z2-9]{3}$, e.g. "DEHAM"). You can also pass lat/long (format: ^[-+]?\d{1,3}\.\d{1,10}\s?,\s?[-+]?\d{1,3}\.\d{1,10}$, e.g. "+40.712,-74.006").

  • "destination": SQUAKE will try to resolve the origin/destination regardless of its format. Ideally, for addresses use the Post standard, for airports use IATA/ICAO code (format: ^[A-Z]{3,4}$, e.g. "MUC"), for other locations used in trade and transportation use UN/LOCODE codes (format: ^[A-Z]{2}\W?[A-Z2-9]{3}$, e.g. "DEHAM"). You can also pass lat/long (format: ^[-+]?\d{1,3}\.\d{1,10}\s?,\s?[-+]?\d{1,3}\.\d{1,10}$, e.g. "+40.712,-74.006").

  • "distance_in_km": Prioritized over origin and destination. If you don't have a distance_in_km, you can use origin and destination and the distance will be automatically resolved. If you pass both distance_in_km and origin/destination, then distance_in_km will be used.

  • "aircraft_size": Supports values like under_220_seats, under_50_seats, under_50_seats_jet, or defaults to average if not passed.

  • "sustainable_fuels": Indicates the usage of sustainable fuels. This lowers the computed emissions in SQUAKE but is not part of the current official emissions frameworks.

  • "radiative_forcing_index": Defaults to true.

  • "carbon_reduction_percentage_of_total": The percentage of emissions reduction through the usage of sustainable fuel. The minimum value is 0, and the maximum value is 1. Default value is 0.

  • Default Values

    • "radiative_forcing_index": true

Sample API Response

{
    "carbon_quantity": 632000,
    "carbon_unit": "gram",
    "items": [
        {
            "carbon_quantity": 632000,
            "carbon_unit": "gram",
            "external_reference": "test_1",
            "type": "flight",
            "methodology": "BASE-EMPREINTE",
            "distance": 6320.0,
            "distance_unit": "kilometer"
        }
    ]
}

Bibliography

  • ADEME. (2025). Base Empreinte - Donnรฉes dโ€™impacts environnementaux. Retrieved from https://www.ademe.fr/base-empreinte

  • ADEME. (2024). Base Carbone Methodological Guide. Retrieved from https://www.ademe.fr/base-carbone

  • ADEME. (2023). Documentation on aviation emission factors. Available via official ADEME publications.

  • Eurocontrol (2022). Aircraft performance and fuel consumption statistics.

๐Ÿ—„๏ธ
๐ŸŒ
โœˆ๏ธ
๐Ÿ’ก