REST API · v1.3

The Carbon-first API
for your technical stack

50 REST endpoints to read, write and analyze your organization's carbon data. Integrate Kabaun into your IS, BI tools or AI agents.

Request accessContact the team
OAuth2 · KeycloakJSON / RESTMCP available
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+
REST endpoints covering the full carbon lifecycle
500+
Emission factors (ADEME, DEFRA, EXIOBASE, Watershed)
4
Supported standards : GHG Protocol, Bilan Carbone®, ISO 14064, CSRD
OAuth2
Secure authentication : Keycloak Password Grant

ENDPOINTS · 7 RESOURCES

The full carbon lifecycle, in REST

Each resource exposes complete CRUD operations and aggregates. Data flows in JSON and complies with GHG Protocol and CSRD standards.

Projects
Carbon project hierarchy. Create, duplicate and structure your reporting scopes.
GETPOSTPUTDELETE
8 endpoints
Activities
Scope 1, 2 and 3 emission sources. Unit or bulk entry via create_many.
GETPOSTPUTDELETE
8 endpoints
Factors
500+ emission factors (ADEME, DEFRA, EXIOBASE…). Multi-field search, filter by contributor.
GETPOSTDELETE
6 endpoints · 500+ facteurs
Impacts
Calculated results in kgCO₂e. Aggregation by scope, project, category or type.
GETPOSTPUTDELETE
8 endpoints + agrégats
Reports
BEGES, GHG Protocol and CSRD report generation with time filters and configurable views.
GETPOSTPUTDELETE
5 endpoints
Targets
SBTi or internal reduction targets. Set reference year, target year and value.
GETPOSTPUTDELETE
5 endpoints
Actions
Decarbonization action plans. Prioritize by estimated reduction, cost and completion status.
GETPOSTPUTDELETE
6 endpoints
MCP · AI Agents
Native MCP protocol for Claude and other AI agents. 50 tools available to read and write carbon data via natural language.
MCPClaude
50 tools disponibles
INTEGRATION · OPEN API

An API built for
teams that automate

The Kabaun API is built around a simple principle: every piece of carbon data must be accessible and modifiable programmatically. No usage limits, no proprietary format.

The base URL is unique : api.agkarb.kabaun.earth, with a Keycloak token auth managed automatically (refresh 60s before expiration).

  • Unified JSON format across all endpoints : success, data, errors
  • Multi-dimensional aggregates: scope, project, category, period
  • Bulk operations: create_many to import hundreds of activities
  • Native MCP: 50 tools to integrate directly with Claude or any AI agent
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

USE CASES · INTEGRATIONS

Who uses the Kabaun API?

From SI integrators to carbon data scientists, the API adapts to every technical context.

ERP / IS Integration
Connect your consumption flows (energy bills, purchases, travel) directly from SAP, Oracle or Sage to Kabaun without manual entry.
ERP · SAP · Oracle
Automated ESG reporting
Generate BEGES and CSRD reports programmatically. Schedule annual exports and feed your non-financial reporting tools.
CSRD · BEGES · GHG
AI Agents & MCP
Connect Claude or your own agent to the Kabaun MCP. The agent can query carbon inventories, suggest emission factors and create action plans.
MCP · Claude · AI Agents
BI Dashboards
Consume Kabaun aggregates in Tableau, Power BI or Looker. Visualize Scope 1/2/3 evolution in real time without manual export.
BI · Tableau · Power BI

COMPLIANCE · 4 STANDARDS

Your data, compliant by design

Each calculated impact is linked to a standard. The API exposes the reference framework used in every response.

GHG Protocol
International standard for greenhouse gas inventories. Scope 1, 2 and 3 categorized under the Corporate Standard.
Bilan Carbone®
ADEME reference method in France. Emission factors sourced directly from the official Base Carbone.
ISO 14064
International standard for quantification and reporting of GHG emissions at the organizational level.
CSRD / ESRS
ESRS E1 indicators automatically structured to feed your CSRD sustainability report.

Ready to integrate
carbon data into your stack?

Request access to the Kabaun API. Our technical team will support you through integration.

Request accessTalk to an engineer
Secure OAuth2Full documentationTechnical support included