Available calculators

Examples

Offset shipping emissions

• Create account
• Add carbon credits
• Calculate flight emissions
• Create an order
• Get certificate

Calculate Emission By Distance [POST]

BASE URL

https://api-calculators.carbonext.com.br/v2/calculators/distance

This request returns the amount of tCO_2eq that the delivery or transport will issue, based on a given distance and transport. The default unit of measurement is kilometers (km).

Request Parameters

Parameter	Description
type	The type identifier from the GET Types request
distance	The distance to be traveled, in meters

Response attributes

Attributes	Description
emission	The total amount of tCO2eq emitted during the travel
emissionUnit	The unit of the emission, based on the Type parameter used in the request (responseUnit)

Example Request

var axios = require('axios');
var data = JSON.stringify({
        "type": 0,
        "distance": 100000,
        "currency": "BRL"

});

var config = {
        method: 'post',
        url: 'https://api-calculators.carbonext.com.br/v2/calculators/distance',
        headers: { 
                'Content-Type': 'application/json'
        },
        data : data
};

axios(config)
        .then(function (response) {
                console.log(JSON.stringify(response.data));
        })
        .catch(function (error) {
                console.log(error);
        });

Example Response

{
        "emission": 0.03885,
        "emissionUnit": "tCO2eq/tonne"
}

Calculate Transport Emission By Zip Code [POST]

BASE URL

https://api-calculators.carbonext.com.br/v2/calculators/distance/zipcode

This endpoint calculates the amount of tCO_2eq emitted when traveling between two locations, for example, ZipCodes for road transport types (only Brazilian Zip Codes are supported for now) or airport codes for flight transport type.

Request Parameters

Parameter	Description
type	The type identifier from the 'GET Types' request
originZipcode	The code that the transport will depart from
destinyZipcode	The code that the transport will arrive at
unitValue	The unit amount to calculate the emissions for (i.e, 10 passengers, 10000 grams, etc.). The unit is specified by the field 'requestUnit' from the 'GET Types' request

Response attributes

Attributes	Description
emission	The total amount of tCO2eq emitted during the travel
emissionUnit	The value is tCO2eq. The result is calculated for the unitValue provided in the request

Example Request

var axios = require('axios');
var data = JSON.stringify({
        "type": 0,
        "originCode": "01526-000",
        "destCode": "66060425",
        "unitValue": 20000
});

var config = {
        method: 'post',
        url: 'https://api-calculators.carbonext.com.br/v2/calculators/distance/zipcode',
        headers: { 
                'Content-Type': 'application/json'
        },
        data : data
};

axios(config)
        .then(function (response) {
                console.log(JSON.stringify(response.data));
        })
        .catch(function (error) {
                console.log(error);
        });

Example Response

{
        "emission": 0.0293110549184694,
        "emissionUnit": "tCO2eq"
}

Calculate Transport Emission by Geographic Coordinates [POST]

BASE URL

https://api-calculators.carbonext.com.br/v2/calculators/distance/latlong

This endpoint calculates the amount of tCO_2eq emitted when traveling between two locations using geographic coordinates (latitude and longitude) of the place of origin and place of destination, for types of road transport or airport codes for the type of air transport.

Request Parameters

Parameter	Description
type	The type identifier from the 'GET Types' request
fuelType	The code of the type of fuel used
originLat	Latitudinal geographical coordinate of the origin
destinyLat	Latitudinal geographic coordinates of the destination
originLong	Longitudinal geographical coordinate of the origin
destinyLong	Longitudinal geographical coordinate of the destination

Response attributes

Attributes	Description
emission	The total amount of tCO2eq emitted during the travel
emissionUnit	The value is tCO2eq. The result is calculated for the unitValue provided in the request

Example Request

var axios = require('axios');
var data = JSON.stringify({
        "type": "Car",
        "fuelType": 0,
        "originLat": -23.5966212,
        "originLong": -46.6890071,
        "destinyLat": -1.3413509,
        "destinyLong": -48.5205929
});

var config = {
        method: 'post',
        url: 'https://api-calculators.carbonext.com.br/v2/calculators/distance/latlong',
        headers: { 
                'Content-Type': 'application/json'
        },
        data : data
};

axios(config)
        .then(function (response) {
                console.log(JSON.stringify(response.data));
        })
        .catch(function (error) {
                console.log(error);
        });

Example Response

{
        "emission": 0.0627173584124599,
        "emissionUnit": "tCO2eq"
}

Calculate Transport Emission By IATA Airport Code [POST]

BASE URL

https://api-calculators.carbonext.com.br/v2/calculators/distance/flight

This endpoint calculates the amount of tCO_2eq emitted when traveling between two airports using the IATA origin and destination code.

Request Parameters

Parameter	Description
type	The type identifier from the 'GET Types' request
originCode	Origin airport IATA code
destinyCode	Destiny airport IATA code
unitValue	The unit amount to calculate the emissions for (i.e, 10 passengers, 10000 grams, etc.). The unit is specified by the field 'requestUnit' from the 'GET Types' request

Response attributes

Attributes	Description
emission	The total amount of tCO2eq emitted during the travel
emissionUnit	The value is tCO2eq. The result is calculated for the unitValue provided in the request

Example Request

var axios = require('axios');
var data = JSON.stringify({
        "type": "Car",
        "fuelType": 0,
        "originLat": -23.5966212,
        "originLong": -46.6890071,
        "destinyLat": -1.3413509,
        "destinyLong": -48.5205929
});

var config = {
        method: 'post',
        url: 'https://api-calculators.carbonext.com.br/v2/calculators/distance/flight',
        headers: { 
                'Content-Type': 'application/json'
        },
        data : data
};

axios(config)
        .then(function (response) {
                console.log(JSON.stringify(response.data));
        })
        .catch(function (error) {
                console.log(error);
        });

Example Response

{
        "emission": 0.0627173584124599,
        "emissionUnit": "tCO2eq"
}

Calculate Energy Consumption [POST]

BASE URL

https://api-calculators.carbonext.com.br/v2/calculators/electricity

This endpoint calculates the amount of tCO_2eq emitted with the consumption of electrical energy.

Request Parameters

Parameter	Description
consumption	The amount of energy consumption in kilowatts/hour (kW/h)

Response attributes

Attributes	Description
emission	The total amount of tCO2eq emitted, given the amount of energy consumption
emissionUnit	The value is tCO2eq. The result is calculated for the unitValue provided in the request

Example Request

var axios = require('axios');
var data = JSON.stringify({
        "consumption": 10000
});

var config = {
        method: 'post',
        url: 'https://api-calculators.carbonext.com.br/v2/calculators/electricity',
        headers: { 
                'Content-Type': 'application/json'
        },
        data : data
};

axios(config)
        .then(function (response) {
                console.log(JSON.stringify(response.data));
        })
        .catch(function (error) {
                console.log(error);
        });

Example Response

{
        "emission": 0.00065,
        "emissionUnit": "tCO2eq"
}

Calculate Water Consumption [POST]

BASE URL

https://api-calculators.carbonext.com.br/v2/calculators/water

This endpoint calculates the amount of tCO_2eq emitted with the consumption of water.

Request Parameters

Parameter	Description
consumption	The amount of water consumption per cubic meter (m3)

Response attributes

Attributes	Description
emission	The total amount of tCO2eq emitted
emissionUnit	The value is tCO2eq. The result is calculated for the unitValue provided in the request

Example Request

var axios = require('axios');
var data = JSON.stringify({
        "consumption": 10000
});

var config = {
        method: 'post',
        url: 'https://api-calculators.carbonext.com.br/v2/calculators/water',
        headers: { 
                'Content-Type': 'application/json'
        },
        data : data
};

axios(config)
        .then(function (response) {
                console.log(JSON.stringify(response.data));
        })
        .catch(function (error) {
                console.log(error);
        });

Example Response

{
       "emission": 5,
       "emissionUnit": "tCO2eq"
}

Batch Calculation By Zip Code [POST]

BASE URL

https://api-calculators.carbonext.com.br/v2/calculators/distance/zipcode/batch

This endpoint calculates the amount of tCO_2eq with a batch of zip code numbers.

Request Parameters

Parameter	Description
type	The type identifier from the 'GET Types' request
data	A set with the sequence of the postcode of the place of departure, the postcode of the place of destination, and the emission calculation unit, separated by a colon

Response attributes

Attributes	Description
emission	The total amount of tCO2eq emitted
emissionUnit	The value is tCO2eq. The result is calculated for the unitValue provided in the request

Example Request

var axios = require('axios');
var data = JSON.stringify({
    "type": "car",   
    "data": [
        "1424001:13045-603:1",
        "1424001:01408-001:1",
        "1424001:13025-085:1",
        "1424001:06543-610:1"
    ]
});

var config = {
        method: 'post',
        url: 'https://api-calculators.carbonext.com.br/v2/calculators/distance/zipcode/batch',
        headers: { 
                'Content-Type': 'application/json'
        },
        data : data
};

axios(config)
        .then(function (response) {
                console.log(JSON.stringify(response.data));
        })
        .catch(function (error) {
                console.log(error);
        });

Example Response

[
    {
        "emission": 0.0020187118160909,
        "emissionUnit": "tCO2eq"
    },
    {
        "emission": 0.0005,
        "emissionUnit": "tCO2eq"
    },
    {
        "emission": 0.00214649511109054,
        "emissionUnit": "tCO2eq"
    },
    {
        "emission": 0.00066142499653482,
        "emissionUnit": "tCO2eq"
    }
]

Batch Calculation By Flights [POST]

BASE URL

https://api-calculators.carbonext.com.br/v2/calculators/distance/flight/batch

This endpoint calculates the amount of tCO_2eq with a batch of airport IATA codes.

Request Parameters

Parameter	Description
type	The type identifier from the 'GET Types' request
data	Set with a sequence of the departure place zip code, destination place zip code and an

integer greater than zero that represents the number of times the trip is made from the point of origin to the destination (use 1 for "one way" and 2 for "round trip", for example), separated by a colon.

Response attributes

Attributes	Description
emission	The total amount of tCO2eq emitted
emissionUnit	The value is tCO2eq. The result is calculated for the unitValue provided in the request

Example Request

var axios = require('axios');
var data = JSON.stringify({
    "type": "passengerAirplane",
    "data": [
        "GRU:VIX:2",
        "BRA:VIX:1",
        "BRA:DEN:1"
    ]
});

var config = {
        method: 'post',
        url: 'https://api-calculators.carbonext.com.br/v2/calculators/distance/flight/batch',
        headers: { 
                'Content-Type': 'application/json'
        },
        data : data
};

axios(config)
        .then(function (response) {
                console.log(JSON.stringify(response.data));
        })
        .catch(function (error) {
                console.log(error);
        });

Example Response

[
    {
        "emission": 0.272769213920404,
        "emissionUnit": "tCO2eq"
    },
    {
        "emission": 0.195776427057759,
        "emissionUnit": "tCO2eq"
    },
    {
        "emission": 1.93205999877386,
        "emissionUnit": "tCO2eq"
    }
]