REST API · v1.3

L'API Carbon-first
pour votre stack technique

50 endpoints REST pour lire, écrire et analyser les données carbone de votre organisation. Intégrez Kabaun dans votre SI, vos outils BI ou vos agents IA.

Demander l'accèsContacter l'équipe
OAuth2 · KeycloakJSON / RESTMCP disponible
api.kabaun.earth · REST v1.3
$# Authentification OAuth2
$POST/auth/token → 200 OK
$GET /projects → 12 projets
$GET /impacts/aggregates → 2 047 tCO₂e
$GET /factors?contributor=ADEME
→ 500+ facteurs d'émission
$POST /activities/create/activity
→ 201 Created id: 4821
$POST /reports/create → BEGES
50+
Endpoints REST couvrant le cycle carbone complet
500+
Facteurs d'émission (ADEME, DEFRA, EXIOBASE, Watershed)
4
Standards supportés : GHG Protocol, Bilan Carbone®, ISO 14064, CSRD
OAuth2
Authentification sécurisée : Keycloak Password Grant

ENDPOINTS · 7 RESSOURCES

Tout le cycle carbone, en REST

Chaque ressource expose des opérations CRUD complètes et des agrégats. Les données circulent en JSON et sont conformes aux standards GHG Protocol et CSRD.

Projets
Hiérarchie de projets carbone. Créez, dupliquez et structurez vos périmètres de reporting.
GETPOSTPUTDELETE
8 endpoints
Activités
Sources d'émissions Scope 1, 2 et 3. Alimentation unitaire ou en masse via create_many.
GETPOSTPUTDELETE
8 endpoints
Facteurs
500+ facteurs d'émission (ADEME, DEFRA, EXIOBASE…). Recherche multi-champs, filtre par contributor.
GETPOSTDELETE
6 endpoints · 500+ facteurs
Impacts
Résultats calculés en kgCO₂e. Agrégation par scope, projet, catégorie ou type.
GETPOSTPUTDELETE
8 endpoints + agrégats
Rapports
Génération de rapports BEGES, GHG Protocol et CSRD avec filtres temporels et vues configurables.
GETPOSTPUTDELETE
5 endpoints
Cibles
Objectifs de réduction SBTi ou internes. Définissez année de référence, année cible et valeur.
GETPOSTPUTDELETE
5 endpoints
Actions
Plans d'action de décarbonation. Priorisez par réduction estimée, coût et statut de réalisation.
GETPOSTPUTDELETE
6 endpoints
MCP · Agents IA
Protocole MCP natif pour Claude et autres agents IA. 50 tools disponibles pour lire et écrire des données carbone via langage naturel.
MCPClaude
50 tools disponibles
INTÉGRATION · OPEN API

Une API construite pour
les équipes qui automatisent

L'API Kabaun est construite autour d'un principe simple : chaque donnée carbone doit être accessible et modifiable par programme. Pas de limite d'usage, pas de format propriétaire.

La base URL est unique : `api.agkarb.kabaun.earth`, avec une auth token Keycloak gérée automatiquement (refresh 60s avant expiration).

  • Format JSON unifié sur tous les endpoints : success, data, errors
  • Agrégats multi-dimensionnels : scope, projet, catégorie, période
  • Opérations en masse : `create_many` pour importer des centaines d'activités
  • MCP natif : 50 tools pour intégrer directement avec Claude ou tout agent IA
GET /impacts/aggregates
→Response 200 OK
{"scope_1": 487, "unit": "kgCO2e""scope_2": 312, "unit": "kgCO2e""scope_3": 1248, "unit": "kgCO2e""total": 2047, "standard": "GHG Protocol"}
Scope 1+2+3 · ADEME Base Carbone 2024

CAS D'USAGE · INTÉGRATIONS

Qui utilise l'API Kabaun ?

De l'intégrateur SI au data scientist carbone, l'API s'adapte à chaque contexte technique.

Intégration ERP / SI
Connectez vos flux de consommation (factures énergie, achats, déplacements) directement depuis SAP, Oracle ou Sage vers Kabaun sans saisie manuelle.
ERP · SAP · Oracle
Reporting ESG automatisé
Générez vos rapports BEGES et CSRD par programme. Planifiez l'export annuel et alimentez vos outils de reporting extra-financier.
CSRD · BEGES · GHG
Agents IA & MCP
Branchez Claude ou votre propre agent sur le MCP Kabaun. L'agent peut interroger les bilans, suggérer des facteurs d'émission et créer des plans d'action.
MCP · Claude · AI Agents
Tableaux de bord BI
Consommez les agrégats Kabaun dans Tableau, Power BI ou Looker. Visualisez l'évolution Scope 1/2/3 en temps réel sans export manuel.
BI · Tableau · Power BI

CONFORMITÉ · 4 STANDARDS

Vos données, conformes par construction

Chaque impact calculé est rattaché à un standard. L'API expose le référentiel utilisé dans chaque réponse.

GHG Protocol
Standard international pour les inventaires de gaz à effet de serre. Scope 1, 2 et 3 catégorisés selon le Corporate Standard.
Bilan Carbone®
Méthode ADEME de référence en France. Facteurs d'émission issus directement de la Base Carbone officielle.
ISO 14064
Norme internationale pour la quantification et la déclaration des émissions de GES au niveau des organisations.
CSRD / ESRS
Indicateurs ESRS E1 automatiquement structurés pour alimenter votre rapport de durabilité CSRD.

Prêt à intégrer
la donnée carbone dans votre stack ?

Demandez l'accès à l'API Kabaun. Notre équipe technique vous accompagne pour l'intégration.

Demander l'accèsParler à un ingénieur
OAuth2 sécuriséDocumentation complèteSupport technique inclus