Lune Docs Logo

Multi-leg shipments
Sea shipments
Vessel tracking
Road shipments
Air shipments
Emissions visibility widget
CSV upload
Migrate from EcoTransIT

Transactions

Dashboard

Logistics analytics

Spend management analytics

Logistics emissions explanations widget

Carbon credits

Accounts

Emission calculations

Logistics methodology

Carbon credit orders

Authentication
Pagination

General
Single leg

By transaction details
By document

Company
Electricity
Flight
Passenger transportation
Raw emission factor

Emission factors

Analytics
Sustainability pages

Quotes
Orders
Carbon certificates

Projects
Project bundles
Bundle selections
Bundle portfolios
Payments

Accounts
Client accounts

Webhook
Log inContact us

Flight

Create a flight emission estimate

HTTP POST to /v1/estimates/flightEstimate emissions produced by passengers in a commercial airflight.
Request body

Parameters for estimating emissions for commercial plane travel

Either the flight distance or the start/destination airport code (ICAO or IATA).

Cabin of class to be used for the specified passengers. Higher classes account for more emissions since total weight and volume necessary to accomodate the class is higher. This parameter defaults to first.

economy
business
first

Number of passengers the calculation should be applied to. This parameter defaults to 1.

Bundle selection percentages.

The sum of all percentages must equal 100.

If not specified, the preconfigured allocation ratios are going to be used.

If, for each selection, percentage is not provided, the selection is divided equally (best effort) between bundles. percentage must be provided for all or none of the bundles.

Maps a bundle id to an allocation ratio

The bundle's unique identifier

Selects to which precision to truncate quantities specific to carbon offsetting.

g
kg
t

A name used to reference this calculation.

An arbitrary dictionary (key-value pairs) to store application-specific information.

Lune doesn't use this information for order processing. Its purpose is for the API clients to be able to attach arbitrary information (to an order for example) and then retrieve it.

Account-unique identifier provided by the client.

idempotency_key has two purposes:

  1. Clients can safely retry estimate requests without accidentally performing the same operation multiple times.
  2. Clients can use idempotency_key to reconcile estimates with entities on their system.
  • Sample request
    • Response

    Pattern: ^[0-9]+(\.[0-9]+)?$

    Unit, t for tonne, kg for kilogram, g for gram, mg for milligram

    mg
    g
    kg
    t

    An arbitrary dictionary (key-value pairs) to store application-specific information.

    Lune doesn't use this information for order processing. Its purpose is for the API clients to be able to attach arbitrary information (to an order for example) and then retrieve it.

    Account-unique identifier provided by the client.

    idempotency_key has two purposes:

    1. Clients can safely retry estimate requests without accidentally performing the same operation multiple times.
    2. Clients can use idempotency_key to reconcile estimates with entities on their system.

    The emission calculation unique identifier

    Parameters for estimating emissions for commercial plane travel

    Either the flight distance or the start/destination airport code (ICAO or IATA).

    Cabin of class to be used for the specified passengers. Higher classes account for more emissions since total weight and volume necessary to accomodate the class is higher. This parameter defaults to first.

    economy
    business
    first

    Number of passengers the calculation should be applied to. This parameter defaults to 1.

    Bundle selection percentages.

    The sum of all percentages must equal 100.

    If not specified, the preconfigured allocation ratios are going to be used.

    If, for each selection, percentage is not provided, the selection is divided equally (best effort) between bundles. percentage must be provided for all or none of the bundles.

    Maps a bundle id to an allocation ratio

    The bundle's unique identifier

    Selects to which precision to truncate quantities specific to carbon offsetting.

    g
    kg
    t

    A name used to reference this calculation.

    An arbitrary dictionary (key-value pairs) to store application-specific information.

    Lune doesn't use this information for order processing. Its purpose is for the API clients to be able to attach arbitrary information (to an order for example) and then retrieve it.

    Account-unique identifier provided by the client.

    idempotency_key has two purposes:

    1. Clients can safely retry estimate requests without accidentally performing the same operation multiple times.
    2. Clients can use idempotency_key to reconcile estimates with entities on their system.
  • Sample response
    • Errors
    This API operation can return the following errors:
    HTTP status codeError code
    400
    api_version_invalid
    400
    bundle_selection_ratios_invalid
    400
    bundle_selection_bundle_invalid
    400
    order_value_invalid
    400
    bundle_id_invalid
    400
    id_invalid
    400
    distance_invalid
    400
    test_account_name_update_disallowed
    400
    bundle_selection_ratios_invalid_format
    400
    address_not_found