Skip to content

API Base Carbone API

by ADEME

No authHTTPSGovernment
Open documentation ↗

Overview

La Base Carbone est une base de données publique de facteurs d'émissions, nécessaires à la réalisation d’un bilan d’émissions de gaz à effet de serre (GES) et plus généralement tout exercice de comptabilité carbone. ### À quoi sert l’API Base Carbone ? Cette API donne accès à tous les éléments de la base carbone. ### Données On retrouve - entre autres - pour chaque élément : | Nom de la donnée | Description | | ---------------- | ---------------------------------- | | Nom | en français, anglais ou espagnol | | Statut | Validé, Archivé, Brouillon, Refusé | | Catégorie | | | Emission de GES | CO2, CH4, N2O, etc. | ### À propos de la base carbone La base carbone est la base de données de référence de l'article 75 de la loi Grenelle II, relatif à l’obligation de réalisation d’un Bilan GES pour les entreprises de plus de 500 salariés, les établissements publics de plus de 250 agents et les collectivités de plus de 50 000 habitants. Administrée par l'ADEME, sa gouvernance est multi acteurs : 14 membres la composent tels que le Ministère de la Transition écologique et solidaire (MTES), le Mouvement des entreprises de France (MEDEF), le Réseau Action Climat (RAC), l’Association des Professionnels en Conseil Climat (APCC), etc. Son enrichissement est ouvert à tous via la possibilité de contributions externes. Retrouvez le descriptif complet de la Base dans [la rubrique « Base Carbone » du site Bilans GES](https://www.bilans-ges.ademe.fr/fr/accueil/contenu/index/page/presentation/siGra

API Base Carbone is a government API from ADEME. It needs no API key. It is served over HTTPS.

At a glance

Authentication
No auth
HTTPS
Yes
CORS
Unknown
Category
Government
Base URL
https://data.ademe.fr/data-fair/api/v1/datasets/base-carboner

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL
curl -X GET "https://data.ademe.fr/data-fair/api/v1/datasets/base-carboner" \
  -H "Accept: application/json"
JavaScript
const response = await fetch("https://data.ademe.fr/data-fair/api/v1/datasets/base-carboner", {
  method: "GET",
  headers: {
    "Accept": "application/json",
  },
});
const data = await response.json();
console.log(data);
Python
import requests

response = requests.request(
    "GET",
    "https://data.ademe.fr/data-fair/api/v1/datasets/base-carboner",
    headers={
    "Accept": "application/json",
    },
    timeout=30,
)
print(response.json())

Questions

Does the API Base Carbone API need an API key?

No. The API Base Carbone API can be called without an API key or sign-up, which makes it handy for prototypes and front-end demos.

Does the API Base Carbone API support HTTPS?

Yes, the API Base Carbone API is served over HTTPS.

What are alternatives to the API Base Carbone API?

Other Government APIs include EPA, UK Companies House, Open Government, Canada, Federal Register, Census.gov.

Compare alternatives →

Listed from data.gouv.fr (Licence Ouverte).