Share your climate impact

The Fils API and our approach

Fils provides a single API for use in-app and web channels to fetch, mutate, and deliver the data necessary to offset CO emissions across a range of verticals.

Our API-first approach allows our customers to embed carbon offsetting and emission calculations into logistics, payments, and fintech platforms to deliver a unique and programmatically driven experience that brings climate into our clients’ products.

Overview

In this guide, you will learn how to set up a public sustainability page to:

Share your climate impact

Enable your clients to share their climate impact

A sample Sustainability page can be seen here.

Who is this guide for?

This guide is aimed at heads of Sustainability or Growth Specialists to manage their Sustainability page via the Fils dashboard and developers looking to automatically integrate sustainability pages into an existing end-user experience.

Feel free to contact our support team if you encounter any issues integrating our payments use case.

Concepts

Beneficiary – Legal entity that can claim the offsetting benefits and is listed in the official public registry

Certificate – Proof of retired carbon credits in the beneficiary’s name. Can be used in Net Zero audits

Client account – Customers that wish to provide a
Sustainability page to their clients must create a client
account for each client to define their basic characteristics, such as name, currency, and beneficiar

A few words about certificates

Certificates contain links to the official entry in the registry’s retirement ledger.

The account’s beneficiary is the entity in the certificate and the registry claiming the offsetting benefits.

A certificate may list credits as:

Retired – the carbon credits have been fully retired
Allocated, pending retirement – the carbon credits have been purchased but cannot be retired yet.

Create a Sustainability page for your account

Head over to the Filsdashboard.

Navigate to https://dashboard.fils.co/share-your-impact.
Create or edit the page’s public URL. The public URL may be changed if not already taken.
Decide what title, description, and sections you’d like to display. You may opt to display your own description if you prefer.
Click Save to publish the Sustainability page

Create a Sustainability page for your clients

Getting an API key

First, head over to the Lune dashboard and generate a new API key.

Navigate to https://dashboard.fils.co/developers
Select New Test API Key, enter a value in the Name field, and select an account from Default account
Select Save
Copy your API key, as you’ll need it to interact with the Fils API

Create a client account

Certificates contain links to the official entry in the registry’s retirement ledger.

The account’s beneficiary is the entity in the certificate and the registry claiming the offsetting benefits.

A certificate may list credits as:

Retired – the carbon credits have been fully retired
Allocated, pending retirement – the carbon credits have been purchased but cannot be retired yet.

Create a Sustainability page for your account

Head over to the Filsdashboard.

Navigate to https://dashboard.fils.co/share-your-impact.
Create or edit the page’s public URL. The public URL may be changed if not already taken.
Decide what title, description, and sections you’d like to display. You may opt to display your own description if you prefer.
Click Save to publish the Sustainability page