←Back to homeZeroCarbon Logo
API Documentation

Build with ZeroCarbon API

Complete guide to integrating with our carbon accounting platform. Submit emissions data, retrieve analytics, and build powerful climate solutions.

Get StartedView Pricing

Who This Is For

Our API is built for developers and platforms that need programmatic access to carbon accounting infrastructure.

Climate Platforms

Integrate carbon accounting into your sustainability platform or ESG solution

Marketplaces

Add verified carbon credit trading and offsetting to your marketplace

SaaS Tools

Embed emissions tracking in HR, procurement, or operations software

Fintech / ERP

Connect carbon data to financial systems and enterprise resource planning

Use Cases: Automated emissions ingestion from IoT devices • Real-time carbon footprint calculations • Compliance report generation • Carbon credit procurement • Supply chain emissions tracking

Get Started in 3 Steps

From API key to first request in under 5 minutes

1

Get API Key

Upgrade to Professional or Enterprise and generate your API key from the Billing page

API_KEY=zc_abc123def456...
2

Add Authentication

Include your API key in the Authorization header of all requests

Authorization: Bearer YOUR_KEY
3

Make Your First Request

Start submitting emissions data or retrieve analytics from your dashboard

Authentication

Secure your API requests with bearer token authentication

All API requests must include an Authorization header with your API key:

Authorization: Bearer YOUR_API_KEY_HERE

⚠️ Security Note: Never expose your API keys in client-side code or public repositories. Always use environment variables.

API Endpoints

Submit and retrieve emissions data with our REST API

POST/api/v1/emissions/manual-entry

Record emissions manually with detailed tracking and audit support.

Request Body:

{
  "scope": "scope_1",
  "source": "diesel_generator",
  "activity_value": 500,
  "activity_unit": "liters",
  "period": "January 2026",
  "activity_date": "2026-01-15",
  "data_quality": "measured",
  "notes": "Backup generator usage"
}

Response:

{
  "success": true,
  "message": "Emission recorded successfully",
  "emission": {
    "id": "em_abc123",
    "scope": "scope_1",
    "value_tco2e": 1.32,
    "activity_value": 500,
    "source": "diesel_generator"
  },
  "audit": {
    "recorded_by": "user@company.com",
    "timestamp": "2026-01-15T10:30:00Z"
  },
  "calculation_details": {
    "emission_factor": 2.64,
    "result": "1.32 tCO2e"
  }
}
POST/api/v1/calculate/electricity

Calculate emissions from electricity consumption with region-specific grid factors.

Request Body:

{
  "amount_kwh": 1000,
  "country": "IN",
  "state": "Maharashtra",
  "renewable_percentage": 10
}

Response:

{
  "success": true,
  "emissions_kg_co2e": 820,
  "emission_factor": 0.82,
  "grid_mix": {
    "coal": 0.55,
    "renewable": 0.22,
    "gas": 0.08
  },
  "methodology": "IEA Emission Factors"
}
POST/api/v1/calculate/flight

Calculate flight emissions with support for over 4000 airports worldwide.

Request Body:

{
  "origin": "DEL",
  "destination": "BOM",
  "cabin_class": "economy",
  "passengers": 1
}

Response:

{
  "success": true,
  "emissions_kg_co2e": 185.46,
  "distance_km": 1141,
  "emission_factor_per_km": 0.1625,
  "cabin_multiplier": 1.0,
  "route": "DEL → BOM"
}
POST/api/v1/calculate/spend

Calculate Scope 3 emissions using spend-based method with EEIO factors.

Request Body:

{
  "amount": 50000,
  "currency": "INR",
  "category": "transportation",
  "description": "Monthly fleet fuel expenses"
}

Response:

{
  "success": true,
  "emissions_kg_co2e": 26.0,
  "emission_factor": 0.00052,
  "matched_category": "transportation",
  "confidence": 0.85,
  "methodology": "EEIO"
}
GET/api/v1/company/dashboard

Retrieve comprehensive emissions analytics and dashboard data.

Query Parameters:

  • from - Start date (YYYY-MM-DD)
  • to - End date (YYYY-MM-DD)
  • scope - Filter by scope (scope_1, scope_2, scope_3)

Response:

{
  "success": true,
  "total_emissions_tco2e": 145.67,
  "by_scope": {
    "scope_1": 45.23,
    "scope_2": 78.44,
    "scope_3": 22.00
  },
  "trend": [
    {"period": "Jan 2026", "value": 12.45},
    {"period": "Feb 2026", "value": 15.23}
  ],
  "top_sources": [
    {"source": "electricity", "emissions": 78.44},
    {"source": "diesel", "emissions": 45.23}
  ]
}

SDKs & Libraries

Official SDKs for popular languages (Coming Soon)

Node.js SDK

Official Node.js SDK for easy integration with TypeScript support.

npm i zerocarbon-nodejs-sdk
View Documentation →

Python SDK

Official Python SDK for data science workflows and analytics.

pip install zerocarbon
View Documentation →

Rate Limits

Flexible limits to match your integration needs

Dashboard
Only
STARTER
500K
Requests/month
PROFESSIONAL
∞
Unlimited
ENTERPRISE

Note: API access requires Professional (₹14,999/month - 500K requests) or Enterprise (₹49,999/month - Unlimited) plan. Starter plan includes dashboard only.

Need Help?

Our team is here to help you integrate successfully.

Auto Integration GuideContact Support