Register record·API·FR·AGENCY·Updated IrregularVERIFIED · checked 17h ago

A

Carbon Database APIAPI Base Carbone

API Base CarboneCarbon Database API

APIExecutable4/7Query nowOpen workbench Subscribe🇫🇷France

This API provides access to the Base Carbone, a public database of emission factors maintained by ADEME (Agence de la transition écologique), the French agency for ecological transition. It supplies the reference data needed to compile greenhouse gas emissions inventories and carbon accounting exercises. Users can query the full set of emission factors covering various sectors and activities, enabling organizations, businesses, and public bodies in France to calculate and report their carbon footprints in accordance with national methodologies for GHG accounting.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…

climate

⬇ Export CSV List records Run verified request Schema OpenAPI spec Read the docs

Data schema (62 fields)

Filterable via the API (60)

Type_LigneIdentifiant_de_l'élémentStructureType_de_l'élémentStatut_de_l'élémentNom_base_françaisNom_base_anglaisNom_base_espagnolNom_attribut_françaisNom_attribut_anglaisNom_attribut_espagnolNom_frontière_françaisNom_frontière_anglaisCode_de_la_catégorieTags_françaisTags_anglaisTags_espagnolUnité_françaisUnité_anglaisContributeurAutres_ContributeursProgrammeUrl_du_programmeSourceLocalisation_géographiqueSous-localisation_géographique_françaisSous-localisation_géographique_anglaisSous-localisation_géographique_espagnolDate_de_créationDate_de_modificationPériode_de_validitéIncertitudeRéglementationsTransparenceQualitéQualité_TeRQualité_GRQualité_TiRQualité_CQualité_PQualité_MType_posteNom_poste_françaisNom_poste_anglaisNom_poste_espagnolTotal_poste_non_décomposéCO2fCH4fCH4bN2OCode_gaz_supplémentaire_1Valeur_gaz_supplémentaire_1Code_gaz_supplémentaire_2Valeur_gaz_supplémentaire_2Valeur_gaz_supplémentaire_3Valeur_gaz_supplémentaire_4Code_gaz_supplémentaire_5Valeur_gaz_supplémentaire_5Autres_GESCO2b

Click a field to see example values.

Field	Type	Description
Type_Ligne	string	—
Identifiant_de_l'élément	string	—
Structure	string	—
Type_de_l'élément	string	—
Statut_de_l'élément	string	—
Nom_base_français	string	—
Nom_base_anglais	string	—
Nom_base_espagnol	string	—
Nom_attribut_français	string	—
Nom_attribut_anglais	string	—
Nom_attribut_espagnol	string	—
Nom_frontière_français	string	—
Nom_frontière_anglais	string	—
Code_de_la_catégorie	string	—
Tags_français	string	—
Tags_anglais	string	—
Tags_espagnol	string	—
Unité_français	string	—
Unité_anglais	string	—
Contributeur	string	—
Autres_Contributeurs	string	—
Programme	string	—
Url_du_programme	string	—
Source	string	—
Localisation_géographique	string	—
Sous-localisation_géographique_français	string	—
Sous-localisation_géographique_anglais	string	—
Sous-localisation_géographique_espagnol	string	—
Date_de_création	string (date)	—
Date_de_modification	string (date)	—
Période_de_validité	string	—
Incertitude	integer	—
Réglementations	string	—
Transparence	number	—
Qualité	number	—
Qualité_TeR	integer	—
Qualité_GR	integer	—
Qualité_TiR	integer	—
Qualité_C	integer	—
Qualité_P	integer	—
Qualité_M	integer	—
Commentaire_français	string	—
Commentaire_anglais	string	—
Type_poste	string	—
Nom_poste_français	string	—
Nom_poste_anglais	string	—
Nom_poste_espagnol	string	—
Total_poste_non_décomposé	number	—
CO2f	number	—
CH4f	number	—
CH4b	number	—
N2O	number	—
Code_gaz_supplémentaire_1	string	—
Valeur_gaz_supplémentaire_1	number	—
Code_gaz_supplémentaire_2	string	—
Valeur_gaz_supplémentaire_2	number	—
Valeur_gaz_supplémentaire_3	boolean	—
Valeur_gaz_supplémentaire_4	boolean	—
Code_gaz_supplémentaire_5	string	—
Valeur_gaz_supplémentaire_5	boolean	—
Autres_GES	number	—
CO2b	number	—

Schema captured from datafair 7 days ago.

Query the data

Pick columns and a sort, then fetch a live preview straight from the source. Choose an API-filterable column (marked ▾) under “Where” to pick from its list of values.

Where=

Sort by

Sample data (5 records)

Record 1Source: https://ecolab.gitbook.io/documentation- · _score: —

{
  "Source": "https://ecolab.gitbook.io/documentation-agribalyse/",
  "_score": null,
  "Programme": "AGRIBALYSE",
  "Structure": "élément non décomposé",
  "Type_Ligne": "Elément",
  "Qualité_TeR": 4,
  "Tags_anglais": "Agribalyse,,starters and mixed dishes,Caesar's salad (salad",
  "Transparence": 5,
  "Tags_français": "\"Agribalyse,\"\"\tSalade César au poulet (salade verte,entrées et plats composés\"\"\"",
  "Unité_anglais": "kgCO2e/kg (net weight)",
  "Nom_base_anglais": "Caesar's salad (salad",
  "Unité_français": "kgCO2e/kg de poids net",
  "Url_du_programme": "https://app.agribalyse.fr/",
  "Date_de_création": "2021-03-04",
  "Nom_base_français": "\"\"\"\tSalade César au poulet (salade verte\"\"\"",
  "Type_de_l'élément": "Facteur d'émission",
  "Date_de_modification": "2024-05-17",
  "Nom_attribut_anglais": "chicken, croûtons, sauce)",
  "Code_de_la_catégorie": "Achats de biens > Produits agro-alimentaires, plats préparés et boissons > Entrées et plats composés > Salades composées et crudités",
  "Période_de_validité": "31/12/2023",
  "Statut_de_l'élément": "Archivé",
  "Nom_attribut_français": "fromage, croûtos, sauce)",
  "Identifiant_de_l'élément": "34052",
  "Localisation_géographique": "France continentale",
  "Total_poste_non_décomposé": 2.81
}

Record 2Source: Agribalyse 3.1 · _score: —

{
  "Source": "Agribalyse 3.1",
  "_score": null,
  "Qualité": 2.9,
  "Programme": "AGRIBALYSE 3.1",
  "Structure": "élément non décomposé",
  "Type_Ligne": "Elément",
  "Qualité_TeR": 4,
  "Tags_anglais": "Agribalyse,céréales de petit-déjeuner et biscuits,Cereal bar with fruit",
  "Transparence": 5,
  "Tags_français": "céréales de petit-déjeuner et biscuits,\"\"\"Agribalyse,Barre céréalière \"\"\"\"équilibre\"\"\"\" aux fruits\"\"\"",
  "Unité_anglais": "kgCO2e/kg net weight",
  "Nom_base_anglais": "Cereal bar with fruit",
  "Unité_français": "kgCO2e/kg de poids net",
  "Url_du_programme": "https://agribalyse.ademe.fr/app",
  "Date_de_création": "2023-03-16",
  "Nom_base_français": "\"\"\"Barre céréalière \"\"\"\"équilibre\"\"\"\" aux fruits\"\"\"",
  "Commentaire_anglais": "Livraison : Ambiant (long) - Matériau d'emballage : LDPE - Préparation : Pas de préparation",
  "Type_de_l'élément": "Facteur d'émission",
  "Date_de_modification": "2024-05-17",
  "Nom_attribut_anglais": "fortified with vitamins and minerals",
  "Code_de_la_catégorie": "Achats de biens > Produits agro-alimentaires, plats préparés et boissons > Produits céréaliers > Céréales de petit-déjeuner et biscuits",
  "Commentaire_français": "Livraison : Ambiant (long) - Matériau d'emballage : LDPE - Préparation : Pas de préparation",
  "Période_de_validité": "24/02/2026",
  "Statut_de_l'élément": "Valide générique",
  "Nom_attribut_français": "enrichie en vitamines et minéraux",
  "Identifiant_de_l'élément": "40963",
  "Localisation_géographique": "France continentale",
  "Total_poste_non_décomposé": 2.46
}

Record 3Source: Agribalyse 3.1 · _score: —

{
  "Source": "Agribalyse 3.1",
  "_score": null,
  "Qualité": 2.8,
  "Programme": "AGRIBALYSE 3.1",
  "Structure": "élément non décomposé",
  "Type_Ligne": "Elément",
  "Qualité_TeR": 4,
  "Tags_anglais": "Agribalyse,céréales de petit-déjeuner et biscuits,Cereal bar with chocolate",
  "Transparence": 5,
  "Tags_français": "céréales de petit-déjeuner et biscuits,\"\"\"Agribalyse,Barre céréalière \"\"\"\"équilibre\"\"\"\" chocolatée\"\"\"",
  "Unité_anglais": "kgCO2e/kg net weight",
  "Nom_base_anglais": "Cereal bar with chocolate",
  "Unité_français": "kgCO2e/kg de poids net",
  "Url_du_programme": "https://agribalyse.ademe.fr/app",
  "Date_de_création": "2023-03-16",
  "Nom_base_français": "\"\"\"Barre céréalière \"\"\"\"équilibre\"\"\"\" chocolatée\"\"\"",
  "Commentaire_anglais": "Livraison : Ambiant (long) - Matériau d'emballage : LDPE - Préparation : Pas de préparation",
  "Type_de_l'élément": "Facteur d'émission",
  "Date_de_modification": "2024-05-17",
  "Nom_attribut_anglais": "fortified with vitamins and minerals",
  "Code_de_la_catégorie": "Achats de biens > Produits agro-alimentaires, plats préparés et boissons > Produits céréaliers > Céréales de petit-déjeuner et biscuits",
  "Commentaire_français": "Livraison : Ambiant (long) - Matériau d'emballage : LDPE - Préparation : Pas de préparation",
  "Période_de_validité": "24/02/2026",
  "Statut_de_l'élément": "Valide générique",
  "Nom_attribut_français": "enrichie en vitamines et minéraux",
  "Identifiant_de_l'élément": "40964",
  "Localisation_géographique": "France continentale",
  "Total_poste_non_décomposé": 6.09
}

Record 4Source: Agribalyse 3.1 · _score: —

{
  "Source": "Agribalyse 3.1",
  "_score": null,
  "Qualité": 2.8,
  "Programme": "AGRIBALYSE 3.1",
  "Structure": "élément non décomposé",
  "Type_Ligne": "Elément",
  "Qualité_TeR": 4,
  "Tags_anglais": "Agribalyse,Beer,boisson alcoolisées",
  "Transparence": 5,
  "Tags_français": "boisson alcoolisées,\"\"\"Agribalyse,Bière \"\"\"\"coeur de marché\"\"\"\" (4-5° alcool)\"\"\"",
  "Unité_anglais": "kgCO2e/kg net weight",
  "Nom_base_anglais": "Beer",
  "Unité_français": "kgCO2e/kg de poids net",
  "Url_du_programme": "https://agribalyse.ademe.fr/app",
  "Date_de_création": "2023-03-16",
  "Nom_base_français": "\"\"\"Bière \"\"\"\"coeur de marché\"\"\"\" (4-5° alcool)\"\"\"",
  "Commentaire_anglais": "Livraison : Glacé - Matériau d'emballage : Verre - Préparation : Réfrigéré chez le consommateur",
  "Type_de_l'élément": "Facteur d'émission",
  "Date_de_modification": "2024-05-17",
  "Nom_attribut_anglais": "regular (4-5° alcohol)",
  "Code_de_la_catégorie": "Achats de biens > Produits agro-alimentaires, plats préparés et boissons > Boissons > Boissons alcoolisées",
  "Commentaire_français": "Livraison : Glacé - Matériau d'emballage : Verre - Préparation : Réfrigéré chez le consommateur",
  "Période_de_validité": "24/02/2026",
  "Statut_de_l'élément": "Valide générique",
  "Identifiant_de_l'élément": "39789",
  "Localisation_géographique": "France continentale",
  "Total_poste_non_décomposé": 1.12
}

Record 5Source: Agribalyse 3.1 · _score: —

{
  "Source": "Agribalyse 3.1",
  "_score": null,
  "Qualité": 3.1,
  "Programme": "AGRIBALYSE 3.1",
  "Structure": "élément non décomposé",
  "Type_Ligne": "Elément",
  "Qualité_TeR": 4,
  "Tags_anglais": "Agribalyse,Beer,boisson alcoolisées",
  "Transparence": 5,
  "Tags_français": "boisson alcoolisées,\"\"\"Agribalyse,Bière \"\"\"\"de spécialités\"\"\"\" ou d'abbaye\"\"\"",
  "Unité_anglais": "kgCO2e/kg net weight",
  "Nom_base_anglais": "Beer",
  "Unité_français": "kgCO2e/kg de poids net",
  "Url_du_programme": "https://agribalyse.ademe.fr/app",
  "Date_de_création": "2023-03-16",
  "Nom_base_français": "\"\"\"Bière \"\"\"\"de spécialités\"\"\"\" ou d'abbaye\"\"\"",
  "Commentaire_anglais": "Livraison : Glacé - Matériau d'emballage : Verre - Préparation : Réfrigéré chez le consommateur",
  "Type_de_l'élément": "Facteur d'émission",
  "Date_de_modification": "2024-05-17",
  "Nom_attribut_anglais": "\"\"\" \"\"\"\"specialty\"\"\"\"\"\"\"",
  "Code_de_la_catégorie": "Achats de biens > Produits agro-alimentaires, plats préparés et boissons > Boissons > Boissons alcoolisées",
  "Commentaire_français": "Livraison : Glacé - Matériau d'emballage : Verre - Préparation : Réfrigéré chez le consommateur",
  "Période_de_validité": "24/02/2026",
  "Statut_de_l'élément": "Valide générique",
  "Nom_attribut_français": "régionales ou d'une brasserie (degré d'alcool variable)",
  "Nom_frontière_anglais": "from abbey or regional (varying alcohol content)",
  "Identifiant_de_l'élément": "39790",
  "Localisation_géographique": "France continentale",
  "Total_poste_non_décomposé": 1.12
}

Live sample captured at profiling time — values may have changed upstream.

Verification Status

Using the API

Configuration

Base URL: https://data.ademe.fr/data-fair/api/v1/datasets/base-carboner
Format: openapi

License

Licence Ouverte 2.0 (France / Etalab)Open

✓ Redistributable
✓ Attribution required

Query examples

curl -s 'https://data.ademe.fr/data-fair/api/v1/datasets/base-carboner/lines?size=20' -H 'Accept: application/json'

First 20 records of the dataset as JSON.

Full API documentation ↗

Dataset

Volume & freshness

Records

19k

18616

Update cadence

Irregular

declared upstream

Last upstream update

1 year ago

2025-07-03

License

No license declared upstream.

○ Documentation○ Data dictionary○ Versioning

Source: datafair

Machine-readable & source

OpenAPI spec JSON

Embed this badge in a README or wiki — it always shows the latest verification state and quality tier.

Carbon Database APIAPI Base Carbone

Trust score

Data schema (62 fields)

Query the data

Sample data (5 records)

Verification Status

Using the API

Configuration

License

Query examples

Dataset

Volume & freshness

License

Machine-readable & source