Name: CarbonSutra – Calculate Carbon Footprint | Free · $49/mo | API.market
Brand: carbonsutra
SKU: api-carbonsutra-carbon
Availability: InStock
Author: API Market

Shashank Agarwal

# CarbonSutra: Simplifying Carbon Emissions Estimation

**CarbonSutra** is a unified suite of APIs (and optional Google Sheets functions) that makes it easy to estimate greenhouse gas (GHG) emissions for various business activities. Adhering to established standards (e.g., ICAO, IPCC, DEFRA, ECTA, Cornell Hotel Sustainability Index), our goal is to:

- Streamline **Scope 1, Scope 2,** and **Scope 3** emissions calculations.  
- Provide transparent, auditable, and up-to-date factors and methodologies.  
- Support compliance with sustainability and climate reporting frameworks (ISSB, TCFD, GRI, etc.).  

CarbonSutra’s primary API endpoints cover airline travel, hotel stays, vehicle emissions, freight/shipping, e-commerce shipments, electricity usage, and fuel consumption. We also offer **clustering** functionality for storing these emission records in labeled groups (clusters), as well as **supplementary** endpoints (e.g., nearest airport lookup) to aid your custom application development.

---

## Key Use Cases

1. **ESG & Sustainability Reporting**  
   Automate carbon footprint tracking in your in-house systems or commercial platforms.

2. **Compliance & Auditing**  
   Generate standardized GHG estimates for auditing, verification, and regulatory filings.

3. **Product & App Development**  
   Integrate real-time carbon estimates into consumer apps, e-commerce storefronts, supply chain portals, or travel booking engines.

4. **Carbon Offsetting & Climate Strategy**  
   Monitor emissions at a granular level to design offset/mitigation programs.

5. **Google Sheets Integration**  
   For non-developers, use CarbonSutra spreadsheet functions (see [docs](https://www.carbonsutra.com/emissions-by-google-sheets-functions.html)).

---

## Authentication & Base URL

All endpoints require an **x-api-market-key** to be passed in the request header:
```
x-api-market-key: YOUR_API_KEY
```
Sign up on [API.market](https://api.market/store/carbonsutra/carbon) to obtain your API key.

**Base URL** (as shown in the example OpenAPI specification):
```
https://api.magicapi.dev/api/v1/carbonsutra/carbon
```
Each endpoint below is appended to this base path, for instance:
```
https://api.magicapi.dev/api/v1/carbonsutra/carbon/api/v1/flight_estimate
```

No **Bearer token** is used or required—**all requests** rely solely on the `x-api-market-key` header for authentication.

---

## Emission Clusters

**Clustering** lets you group your emission calculations under a `cluster_name` (e.g., “ProjectX-2025”, “Marketing-Q4”), which CarbonSutra stores on your behalf. This way, you can **retrieve** historical calculations or aggregated footprints later without maintaining your own storage.

### Related Endpoints

1. **Register Key**  
   ```
   POST /carbonsutra/public/api/v1/register_key
   ```
   - Generates or registers a dedicated key for cluster usage.  
   - Input typically includes email and a secret phrase/password.  
   - Your `x-api-market-key` header must be present in the request.

2. **Retrieve Key**  
   ```
   POST /carbonsutra/public/api/v1/retrieve_key
   ```
   - Retrieve your key again if you’ve misplaced it.  
   - Input typically requires the same password used at registration.  
   - Your `x-api-market-key` header must be present in the request.

3. **Cluster Data**  
   ```
   GET /carbonsutra/public/api/v1/cluster_data?cluster_name=YOUR_CLUSTER
   ```
   - Returns all emission calculations associated with `cluster_name`.  
   - Pass your `x-api-market-key` in the header to authenticate.

**Including a `cluster_name`** in your emission-creation requests (e.g., flight, hotel) automatically ties those calculations to that cluster. Later, query `cluster_data` to retrieve them.

If you **do not** need clustering, you can ignore these endpoints and simply use the emission estimation endpoints directly.

---

## Supplementary APIs

These APIs enhance your front-end or logic for advanced location-based calculations.

### 1. Nearest Airport

```
GET /api/v1/nearest-airport
```
- **Query Params**: 
  - `country_code`: ISO country code (e.g., `US`)  
  - `postal_code`: numeric or alphanumeric postal/ZIP code  
- **Description**: Returns the **nearest** airport (IATA code, name) and the straight-line distance in kilometers from the given postal code.  
- **Example**:
  ```bash
  curl --request GET \
       --url "https://api.magicapi.dev/api/v1/carbonsutra/carbon/api/v1/nearest-airport?country_code=US&postal_code=94105" \
       --header "x-api-market-key: YOUR_API_KEY"
  ```

### 2. Distance Between Airports

```
GET /api/v1/distance-between-airports
```
- **Query Params**:
  - `iata_airport_from` (e.g., `LHR`)  
  - `iata_airport_to`   (e.g., `MAA`)  
- **Description**: Returns the **distance (km)** between two airports using their IATA codes.  
- **Example**:
  ```bash
  curl --request GET \
       --url "https://api.magicapi.dev/api/v1/carbonsutra/carbon/api/v1/distance-between-airports?iata_airport_from=LHR&iata_airport_to=MAA" \
       --header "x-api-market-key: YOUR_API_KEY"
  ```

### 3. Airports by Keyword

```
GET /api/v1/airports-by-keyword
```
- **Query Params**:
  - `keyword`: search string (e.g., `New`, `Sing`)  
- **Description**: Retrieves a list of **airport names and IATA codes** matching the input keyword. Ideal for autocomplete or location pickers.  
- **Example**:
  ```bash
  curl --request GET \
       --url "https://api.magicapi.dev/api/v1/carbonsutra/carbon/api/v1/airports-by-keyword?keyword=New" \
       --header "x-api-market-key: YOUR_API_KEY"
  ```

---

## Main Emission Estimation Endpoints

Below are the core endpoints you’ll use to **calculate** specific emission footprints. All require the header:

```
x-api-market-key: YOUR_API_KEY
```

You can optionally include `cluster_name` in your JSON payload to store the result in a named cluster for later retrieval.

### 1. Flight Travel Estimates

```
POST /api/v1/flight_estimate
```
**Use Case**: Calculate Scope 3 emissions for flight travel.  
**Methodology**: ICAO, IPCC’s radiative forcing factors (optionally included), WTT (well-to-tank) factors (optionally included).

**Request Body** (example):
```json
{
  "cluster_name": "ProjectAlpha-Q1",
  "iata_airport_from": "DXB",
  "iata_airport_to": "LAX",
  "flight_class": "Business",
  "round_trip": "Y",
  "add_rf": "N",
  "include_wtt": "Y",
  "number_of_passengers": "1"
}
```

**Example Response**:
```json
{
  "data": {
    "type": "estimate-travel-flight",
    "iata_airport_from": "DXB",
    "airport_from": "Dubai International Airport",
    "iata_airport_to": "LAX",
    "airport_to": "Los Angeles International Airport",
    "flight_class": "Business",
    "round_trip": "Y",
    "add_rf": "N",
    "include_wtt": "Y",
    "number_of_passengers": "1",
    "co2e_gm": 6974671,
    "co2e_kg": 6974.67,
    "co2e_mt": 6.97,
    "co2e_lb": 15376.36
  },
  "success": true,
  "status": 200
}
```

---

### 2. Hotel Stay Estimates

```
POST /api/v1/hotel_estimate
```
**Use Case**: Calculate emissions from hotel stays.  
**Methodology**: Cornell Hotel Sustainability Benchmark Index + UK government GHG factors. Covers 38 countries, 300+ cities/regions.

**Request Body** (example):
```json
{
  "cluster_name": "KrugerBrent-Jun22",
  "country_code": "AU",
  "city_name": "Sydney",
  "hotel_rating": "5",
  "number_of_nights": "2",
  "number_of_rooms": "1"
}
```

**Example Response**:
```json
{
  "data": {
    "type": "estimate-hotel-stay",
    "country": "Australia",
    "city_name": "Sydney",
    "hotel_rating": "5",
    "number_of_nights": "2",
    "number_of_rooms": "1",
    "co2e_gm": 80900,
    "co2e_kg": 80.9,
    "co2e_mt": 0.08,
    "co2e_lb": 178.35
  },
  "success": true,
  "status": 200
}
```

---

### 3. Vehicle Estimates by Type

```
POST /api/v1/vehicle_estimate_by_type
```
**Use Case**: Calculate emissions based on **vehicle category** (size/type) for a given distance.  
**Methodology**: Factors from UK Gov GHG, US Dept of Energy, US EPA, etc.  
**Vehicle Types**: e.g., `Car-Type-Supermini`, `Car-Size-Large`, `Bus-Coach`, `Train-National`, etc.

**Request Body** (example):
```json
{
  "cluster_name": "VE-Oct-2022",
  "vehicle_type": "Car-Type-Supermini",
  "fuel_type": "petrol",
  "distance_value": 8800,
  "distance_unit": "km",
  "include_wtt": "N"
}
```

**Example Response**:
```json
{
  "data": {
    "type": "estimate-vehicle-usage",
    "vehicle_type": "Car-Type-Supermini",
    "fuel_type": "petrol",
    "distance_value": 8800,
    "distance_unit": "km",
    "include_wtt": "N",
    "co2e_gm": 1302576,
    "co2e_kg": 1302.58,
    "co2e_mt": 1.3,
    "co2e_lb": 2871.67
  },
  "success": true,
  "status": 200
}
```

---

### 4. Vehicle Estimates by Model

```
POST /api/v1/vehicle_estimate_by_model
```
**Use Case**: Calculate emissions based on **specific vehicle make/model** for a given distance.  
**Methodology**: Aggregated from US EPA, UK Society of Motor Manufacturers, multiple data sources. Over 140 makes and 4,500 models covered.

**Request Body** (example):
```json
{
  "cluster_name": "VE-Oct-2022",
  "distance_unit": "km",
  "distance_value": "11500",
  "vehicle_make": "Lexus",
  "vehicle_model": "RX 300"
}
```

**Example Response**:
```json
{
  "data": {
    "type": "estimate-vehicle",
    "distance_unit": "km",
    "distance_value": "11500",
    "vehicle_make": "Lexus",
    "vehicle_model": "RX 300",
    "co2e_gm": 3453751,
    "co2e_kg": 3453.75,
    "co2e_mt": 3.45,
    "co2e_lb": 7614.14
  },
  "success": true,
  "status": 200
}
```

#### Supporting Endpoints

- **List Vehicle Makes**  
  `GET /api/v1/vehicle_makes`  
- **List Vehicle Models for a Make**  
  `GET /api/v1/vehicle_makes/toyota/vehicle_models`  

These endpoints return valid **makes** and **models** you can pass to `/vehicle_estimate_by_model`.

---

### 5. Electricity Usage Estimates

```
POST /api/v1/electricity_estimate
```
**Use Case**: Calculate **Scope 2** (indirect) emissions from electricity consumption.  
**Data Coverage**: ~90 countries (2020-22 factors).  
**Request Body** (example):
```json
{
  "cluster_name": "KrugerBrent-Jun22",
  "electricity_unit": "mwh",
  "electricity_value": "1745",
  "country_name": "UK"
}
```
**Example Response**:
```json
{
  "data": {
    "type": "estimate-electricity",
    "electricity_unit": "MWh",
    "electricity_value": "1745",
    "country_name": "UK",
    "co2e_gm": 337448100,
    "co2e_kg": 337448.1,
    "co2e_mt": 337.45,
    "co2e_lb": 743938.08
  },
  "success": true,
  "status": 200
}
```

---

### 6. Fuel Consumption Estimates

```
POST /api/v1/fuel_estimate
```
**Use Case**: Calculate emissions from **stationary fuel combustion** (Scope 1) or other usage (transport/residential).  
**Supported Fuels**: Petrol (premium/regular), diesel, LPG, coal (various grades), natural gas, aviation kerosene, etc.  
**Request Body** (example):
```json
{
  "cluster_name": "KrugerBrent-Jun22",
  "fuel_usage": "transport",
  "fuel_name": "Regular Petrol",
  "fuel_value": "7900"
}
```

**Example Response**:
```json
{
  "data": {
    "type": "estimate-fuel",
    "fuel_usage": "transport",
    "fuel_name": "Regular Petrol",
    "fuel_unit": "litre",
    "fuel_value": "7900",
    "co2e_gm": 19400623,
    "co2e_kg": 19400.62,
    "co2e_mt": 19.4,
    "co2e_lb": 42770.61
  },
  "success": true,
  "status": 200
}
```

---

### 7. Freight Shipping Estimates

```
POST /api/v1/freight_estimate
```
**Use Case**: Calculate emissions for freight or cargo shipping by **road, rail, sea, air,** or **intermodal**.  
**Methodology**: ECTA & Cefic guidelines, with adjustable short-sea vs. deep-sea.  
**Request Body** (example):
```json
{
  "cluster_name": "KrugerBrent-Oct22",
  "transport_mode": "Rail",
  "distance_value": "1500",
  "freight_weight": "20000"
}
```

**Example Response**:
```json
{
  "data": {
    "type": "estimate-freight",
    "distance_value": "1500",
    "transport_mode": "Rail",
    "freight_weight": "2000",
    "co2e_gm": 66000,
    "co2e_kg": 66,
    "co2e_mt": 0.07,
    "co2e_lb": 145.5
  },
  "success": true,
  "status": 200
}
```

---

### 8. eCommerce Shipment Estimates

```
POST /api/v1/ecommerce_estimate
```
**Use Case**: Automate advanced calculations of eCommerce package shipments, factoring in:
1. Land transport from origin postal code to nearest airport.
2. Air travel between those airports.
3. Land transport from destination airport to final postal code.

**Request Body** (example):
```json
{
  "cluster_name": "KrugerBrent_Oct22",
  "origin_country_code": "IN",
  "origin_postal_code": "604407",
  "destination_country_code": "IN",
  "destination_postal_code": "226017",
  "package_weight": "10",
  "add_rf": "N",
  "include_wtt": "N"
}
```

**Example Response**:
```json
{
  "data": {
    "type": "estimate-ecommerce",
    "origin_country_code": "IN",
    "origin_postal_code": "603104",
    "destination_country_code": "IN",
    "destination_postal_code": "226017",
    "package_weight": "15",
    "add_rf": "N",
    "include_wtt": "N",
    "co2e_gm": 242,
    "co2e_kg": 0.24,
    "co2e_mt": 0,
    "co2e_lb": 0.53
  },
  "success": true,
  "status": 200
}
```

---

## Example OpenAPI Specification (Excerpt)

Below is a **truncated** example of how our OpenAPI spec is structured. For the full definition, refer to the listing on [API.market](https://api.market/store/carbonsutra/carbon) or [CarbonSutra documentation](https://www.carbonsutra.com/).

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "CarbonSutra",
    "description": "Carbon Emission Footprint Estimation for Organizations...",
    "version": "1.0.1"
  },
  "servers": [
    {
      "url": "https://api.magicapi.dev/api/v1/carbonsutra/carbon"
    }
  ],
  "paths": {
    "/api/v1/flight_estimate": {
      "post": {
        "summary": "Flight Travel Estimates",
        "description": "...",
        "requestBody": {
          "content": {
            "application/json": {}
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    ...
  }
}
```

---

## Pricing & Rate Limits

- **Free Tier**: Limited monthly calls for testing and small-scale usage.  
- **Paid Plans**: Scale to larger volumes and enterprise integrations.  
- **Custom Solutions**: Contact us for dedicated on-prem solutions, custom data modeling, or specialized algorithms.

---

## Contact & Support

- **Live Chat**: On the [API.market store page](https://api.market/store/carbonsutra/carbon), you’ll find an embedded chat for real-time assistance.  
- **Email**: [hello@api.market](mailto:hello@api.market)  
- **Website**: [https://www.carbonsutra.com](https://www.carbonsutra.com)  
- **Video Introduction**: [YouTube Overview](https://www.youtube.com/watch?v=jfkx9DD5uaI)

We are a team of **climate-tech professionals** dedicated to making reliable carbon accounting accessible to everyone. Let CarbonSutra power your sustainability initiatives, ESG reporting, and climate action strategies!

---

## Conclusion

**CarbonSutra** offers a **comprehensive** and **flexible** approach to carbon emissions estimation, covering everything from flight and hotel stays to freight and eCommerce shipments—all under one roof. With clustering, advanced distance calculations, and an ever-expanding database of emission factors, you can confidently integrate carbon footprint analytics into your own products, dashboards, or enterprise systems.

> **Get started today** on [API.market](https://api.market/store/carbonsutra/carbon). If you have any questions or need support, our team is just a chat or email away. Let’s work together toward a **net-zero** future!

Estimate GHG emissions for travel, freight, energy & more. Free 500 calls/mo, from $49/mo. Start free on API.market.

CarbonSutra – Calculate Carbon Footprint | Free · $49/mo | API.market

CarbonSutra API