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.

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

Sign up and generate your API key from the API Keys page in one click

API_KEY=zc_live_abc123...
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/company/emissions/submit

Submit emissions data to your company account.

Request Body:

{
  "scope": 1,
  "source": "electricity",
  "value": 1500,
  "unit": "kWh",
  "activity_date": "2026-01-07",
  "location": "Mumbai, India"
}

Response:

{
  "success": true,
  "emission": {
    "id": "em_abc123",
    "scope": 1,
    "value_tco2e": 1.23,
    "created_at": "2026-01-07T12:00:00Z"
  }
}
GET/api/v1/company/emissions

Retrieve emissions data and analytics for your company.

Query Parameters:

  • start_date - Start date (YYYY-MM-DD)
  • end_date - End date (YYYY-MM-DD)
  • scope - Filter by scope (1, 2, or 3)

Response:

{
  "success": true,
  "emissions": [
    {
      "id": "em_abc123",
      "scope": 1,
      "source": "electricity",
      "value_tco2e": 1.23,
      "activity_date": "2026-01-07",
      "created_at": "2026-01-07T12:00:00Z"
    }
  ],
  "total_tco2e": 1.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

1,000
Requests/hour
FREE Tier
50,000
Requests/hour
PRO Tier
Unlimited
ENTERPRISE

Note: Rate limits are applied per API key. Contact us for custom rate limits.

Need Help?

Our team is here to help you integrate successfully.