@import url("https://fonts.googleapis.com/css?family=Noto+Sans:300,400,600,700|Playfair+Display:500,600,700,800&display=swap");

html {
    font-family: 'Noto Sans', sans-serif;
}

h1, h2, h3, h4 {
    font-family: 'Playfair Display', serif;
}

[Deprecated] Use `/quotes/ground-transport` with `passenger_car_van_or_suv` as the `vehicle_type` to calculate ride emissions.
Then pass the result to `/orders` to place the order.
 
Places an order for carbon credits for a vehicle ride of the given distance (in kilometers).
The order will remain in the `placed` state until it can be matched to available credits,
after which the order will be fulfilled and moved to the `fulfilled` state.

Create Carbon Credits Order for Vehicle Ride

Optional configuration for a callback url to invoke with updates
when the status of an order changes.


callback url to invoke when status of the order changes

Information about benefits beyond carbon reduction

The name of the company or organization sponsoring the project

Information about the due diligence performed on the project

Figure illustrating due diligence information

Alt text for the due diligence figure image

Identifier that can be used to retrieve the project details

The type of impact the project has (avoided emissions, removal, or mix of both)

Longitude for the location of the project

List of news articles related to the project

List of notable buyers of credits from this project

Information about the permanence of the carbon removal

The id of the project within the registry

The name of the registry on which the project's credits are registered

The full url to the project's documentation on the registry website

Information about the risk of carbon reversal

List of third-party labels or certifications

Type of project, eg Afforrestation, Renewable Energy, etc

list of UN Sustainable Development Goals supported by this project; see https://sdgs.un.org/goals

Amount (in kg CO₂e) of the order fulfilled from this project

Details of the project for this allocation

List of retirement records for this project allocation

The serial number range of the retired tranche block(s) from which an order's project allocation is taken. The format differs depending on the registry

The url to the retired tranche block(s) record on the project's registry

Details for an order request for offsetting a vehicle ride


ApiKey

Problem details object returned on errors

Forbidden - Billing Not Set Up or Requested Portfolio not Available for the User

Concurrent Requests with Same Idempotency Key

Mismatched Requests with Same Idempotency Key

CNaught API

CNaught makes it easy to help your customers compensate for their carbon footprint.

Introduction

This short tutorial will teach you the basics of making requests to the CNaught APIs.

Quickstart

These examples demonstrate how to build carbon credit user experiences with the CNaught APIs.

Examples

This page documents all notable changes to this project.

Changelog

Overview

Gets a list of orders in reverse chronological order up to the provided `limit` number of orders per call.
Pagination is supported by passing the first order `id` from a previous call into `ending_before` to retrieve the
previous page, or the last order `id` from a previous call into `starting_after` to retrieve the next page.


Get List of Orders

Places an order for the specified amount of carbon credits (in kilograms), or for the specified total price (in USD cents).
The order will remain in the `placed` state until it can be matched to available credits,
after which the order will be fulfilled and moved to the `fulfilled` state.
If specifying total price, we will determine the amount of carbon credits based on the unit price of the portfolio used for the order.
Because the amount must be an integer number of kilograms, the final actual total price might be slightly different than the specified total price.


Create Carbon Credits Order

Get Order By Id

When cancelling an order that has been fulfilled, a credit for the price of the order
will be applied to the current invoice. This means that it is possible for the credit
for a cancellation to appear on the invoice of the following billing period.
For example, if a billing period ends between when the order was placed and when it
is cancelled, then the credit will be applied to the latter billing period rather
than the one during which the order was placed.


Cancel Order

Get a price quote for offsetting the given amount of carbon emissions.


Get Quote by Emissions Mass

Get a price quote for offsetting air freight shipment carbon emissions.
Will return the amount of CO₂e to offset and total price.


Get Quote for Air Freight Emissions

Get a price quote for offsetting flight carbon emissions.
Will return the amount of CO₂e to offset and total price.


Get Quote for Flight Emissions

Get a price quote for offsetting ground freight shipment carbon emissions.
Will return the amount of CO₂e to offset and total price.


Get Quote for Ground Freight Emissions

Get a price quote for offsetting ground transportation carbon emissions.
Will return the amount of CO₂e to offset and total price.


Get Quote for Ground Transport Emissions

Get a price quote for offsetting office space carbon emissions.
Will return the amount of CO₂e to offset and total price.


Get Quote for Office Space Emissions

Get a price quote for offsetting train carbon emissions.
Will return the amount of CO₂e to offset and total price.


Get Quote for Train Emissions

[Deprecated] Use `/orders/ground-transportation` and pass `passenger_car_van_or_suv` as the `vehicle_type`.
 
Get a price quote for offsetting car ride carbon emissions.
Will return the amount of CO₂e to offset and total price.

Get Vehicle Ride Credits Price Quote

Gets a list of subaccounts in reverse chronological order up to the provided `limit` number of subaccounts per call.
Pagination is supported by passing the first subaccount `id` from a previous call into `ending_before` to retrieve
the previous page, or the last subaccount `id` from a previous call into `starting_after` to retrieve the next page.


Get List of Subaccounts

Create Subaccount

Get Subaccount By Id

Updates the Subaccount with the given id.
This does not include updating the logo: there are separate endpoints for doing so.
Aside from the logo, all properties should be included in the request body.
Not including the default portfolio id in the update request will have the effect of making the subaccount not
have an explicit default portfolio (making it inherit the default portfolio from the parent user).


Update Subaccount

Deletes the Subaccount with the given id.
This operation will fail if the subaccount has orders associated with it.


Delete Subaccount

Updates the logo for a Subaccount with given id with the image contents sent in the request body.
The request body should be the binary image contents in a supported image format, and the request
should include a Content-Type header specifying the image content type.
Supported image types are: PNG (image/png), JPEG (image/jpeg), WEBP (image/webp), and SVG (image/svg+xml).


Update Subaccount Logo By Uploading Image Content

Updates the logo for a Subaccount with given id by downloading from given URL. 
The URL should point to a valid image in a supported image format, and should include
the content type for the image in the HTTP response when the image is retrieved from the URL.
Supported image types are: PNG (image/png), JPEG (image/jpeg), WEBP (image/webp), and SVG (image/svg+xml).


Update Subaccount Logo From URL

Removes the logo for a Subaccount with given id.


Remove Logo From Subaccount

Creates a Checkout Session that, when completed, will result in an order
for the specified amount of carbon credits (in kilograms). The total price
must be at least $0.50 (the corresponding amount will depend on the per kg
price of the specified portfolio). The Quotes API can be used to check the
price before attempting to create a session.


Create Checkout Session

Returns the Checkout Session with the given id

Get Checkout Session

Returns information about the total climate impact of the carbon credit purchases for this account (or a subaccount).
This is the underlying information that is displayed on the hosted public impact page for the account / subaccount.
You can optionally use the 'from' and/or 'to' query parameters to only show impact for orders in a particular time period.


Get Climate Impact Data

Returns information about the hosted public climate impact page configuration for the account (or a subaccount)

Get Hosted Climate Impact Page Configuration

Returns information about a project, including credit issuances by vintage year

Get Project By Id

Returns information about a project category

Get Project Category By Id

Gets the list of portfolios the user is able to use for purchasing credits. This list is not paginated - the full list of portfolios is returned.
The portfolio objects in the list do not include details about the project categories comprising the portfolio - those can be retrieved
for each portfolio using the [Get Portfolio By Id](/api/reference/#operation/GetPortfolioById) API endpoint.


Get List of Portfolios

Returns information about a portfolio, including the project categories that comprise the portfolio, as well as price info.

Get Portfolio By Id

Our SDKs make it easier and faster to integrate carbon credits into your application.

API Documentation

Orders

Quotes

Subaccounts

Checkout Sessions

Climate Impact

Projects

Portfolios

Create Carbon Credits Order for Vehicle Ride

Authorizations

Headers

Body

Response