REST API · JSON · OpenAPI Spec

Build on MintCarb API

Carbon prices, credit registry, GHG calculations, CBAM estimator, and credit retirement — all in a single, versioned JSON REST API. Free sandbox. 10,000 calls/day on free tier.

Free sandboxOpenAPI 3.0 specJSON:API responseBearer authVersioned URLsRate limitedIndia-first data

Get free API key API Reference Try sandbox

Base URL:https://api.mintcarb.com

Current version:v1

Auth:Bearer token

Format:JSON

Free tier:10,000 calls/day

Example — Get India Carbon Prices

GET /v1/markets/india

// Get live India carbon prices
const res = await fetch(
  "https://api.mintcarb.com/v1/markets/india",
  {
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
  }
);

const data = await res.json();

// Response
{
  "success": true,
  "data": {
    "ccts": {
      "price": 842,
      "currency": "INR",
      "unit": "tCO2",
      "change_24h": 2.4,
      "volume_24h": 14200,
      "exchange": "IEX Green",
      "updated_at": "2026-06-17T12:30:00Z"
    },
    "escert": {
      "price": 1240,
      "currency": "INR",
      "unit": "tCO2",
      "change_24h": 0.6,
      "exchange": "IEX Green"
    }
  },
  "meta": {
    "request_id": "req_abc123",
    "version": "v1",
    "timestamp": "2026-06-17T12:30:01Z"
  }
}

Example — Retire Carbon Credits

POST /v1/credits/retire

// Retire carbon credits programmatically
const retire = await fetch(
  "https://api.mintcarb.com/v1/credits/retire",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      project_id: "VCS-1234",
      quantity_tonnes: 10,
      beneficiary: "Acme Corp — 2026 Fleet Offset",
      currency: "INR",
    }),
  }
);

// Response
{
  "success": true,
  "data": {
    "retirement_id": "ret_xyz789",
    "certificate_url": "https://mintcarb.com/cert/ret_xyz789",
    "quantity": 10,
    "serial_range": "VCS-1234-2023-001..010",
    "registry_tx": "VERRA-TX-9281736",
    "retired_at": "2026-06-17T12:31:00Z"
  }
}

API Reference

All endpoints return a consistent JSON envelope: { success, data, error, meta }

Market Data

GET/v1/markets/pricesLive carbon prices by geography, credit type, and registryFree tier

GET/v1/markets/indiaIndia CCTS, PAT ESCerts, REC prices from IEX/HPX/PXILFree tier

GET/v1/markets/singaporeSingapore CCS, CIX, AirCarbon pricesFree tier

GET/v1/markets/globalEU ETS, Verra VCS, Gold Standard, ICR global pricesFree tier

GET/v1/markets/price-indexMintCarb Carbon Price Index (MCPI) — India assessed priceFree tier

Credit Registry

GET/v1/creditsBrowse all credits — filter by country, vintage, type, registryFree tier

GET/v1/credits/{id}Full credit project detail with MRV docs and provenanceFree tier

GET/v1/credits/retirementsPublic retirement ledger — all retired credits globallyFree tier

GET/v1/credits/retirements/{id}/certificateFetch public retirement certificate (PDF link)Free tier

POST/v1/credits/quotesGet retirement quote — locks in price for 10 minutesPaid

POST/v1/credits/retireExecute credit retirement — permanent, irreversiblePaid

Calculations

POST/v1/calc/ghgGHG calculation with BEE India + IEA global emission factorsFree tier

POST/v1/calc/cbamEU CBAM tariff estimate for India/Singapore exportersFree tier

POST/v1/calc/footprintQuick personal or SME carbon footprint calculationFree tier

GET/v1/calc/emission-factorsEmission factor library — BEE, IEA, IPCC factorsFree tier

Compliance & Regulations

GET/v1/regulationsAll regulations filterable by geo, framework, statusFree tier

GET/v1/regulations/{geo}Regulations for a specific geography (in, sg, eu, global)Free tier

GET/v1/regulations/deadlinesCompliance deadline calendar — upcoming regulatory datesFree tier

GET/v1/regulations/cctsIndia CCTS rules, allocations, and compliance ratesPaid

Authenticated (Your Account)

POST/v1/emissionsSubmit emission activity data (Scope 1/2/3)Paid

GET/v1/emissions/inventoryGHG inventory for your organizationPaid

GET/v1/compliance/ccts/positionYour CCTS compliance position and deficit/surplusPaid

POST/v1/reports/generateGenerate BRSR, GRI, TCFD, CDP report from your dataPaid

Standard Response Envelope

Every API response — success or error — returns the same JSON structure:

successboolean— true if request succeeded
dataT | null— response payload (typed per endpoint)
errorobject | null— { code, message } on failure
metaobject— { request_id, version, timestamp }

{
  "success": true,
  "data": { ... },
  "error": null,
  "meta": {
    "request_id": "req_abc123",
    "version": "v1",
    "timestamp": "2026-06-17T12:30:01Z"
  }
}

Free Sandbox

10,000 calls/day