CarbonTrace API

One API call. Full lifecycle carbon footprint.

19endpoints. OpenAPI 3.1 spec. Response times that make your other APIs jealous. PAIA-aligned methodology, calibrated within ±5% of manufacturer-published PCFs.

Get API Key OpenAPI SpecBase URL: https://carbontrace.cloud/api/v1

Authentication

Core calculation endpoints work without an API key at free-tier limits (25 requests/day). For production use with higher limits, include your API key. Some endpoints (certificates, reports, Blancco sync) require authentication.

Authorization: Bearer ct_your_api_key_here

Rate Limits

25

Free / day

5/min

1,000

Pro / day

30/min

10,000

Business / day

100/min

100,000

Enterprise / day

500/min

Rate limit headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Plan. When exceeded: 429 with Retry-After header.

OpenAPI 3.1 Specification

Machine-readable spec for code generation, Postman import, or Swagger UI.

Download JSON

Sandbox Mode

Test your integration without side effects. Sandbox API keys return deterministic fixture data — no real calculations, no certificates, no data stored. Your live quota is unaffected.

How it works

1. Create a sandbox key in API Keys (prefix: ct_test_*)

2. Use it exactly like a live key — same endpoints, same headers

3. Responses contain fixed test data with _sandbox: true

Response header

X-CarbonTrace-Mode: sandbox   // or "live" for production keys

Sandbox fixture example

{
  "product": { "brand": "SandboxCorp", "mpn": "TEST-001", "category": "laptop" },
  "total_kg_co2e": 350.42,
  "breakdown": { "production_kg": 285.10, "transport_kg": 14.50, ... },
  "_sandbox": true
}

Endpoint support

Footprint, Batch, Savings, IdentifySupportedSearch, Reference, BlanccoSupportedCertificate (POST: mock, GET: N/A)PartialReportNot applicable (session-auth)

Footprint

Calculate lifecycle carbon footprints for IT devices

Products

Search and identify products via built-in database and Icecat

Certificates

Generate and download verifiable CO₂ impact certificates

Reports

Generate sustainability and hotspot analysis PDF reports

Reference

Countries, grid factors, and device categories

Integrations

Third-party platform integrations (Blancco)

Export

Async org-wide GDPR bulk export jobs

BI Export

OData v4 read-only endpoint for Power BI, Tableau, and Excel. Enterprise-only. Every response is signed with a hash-linked proof header tied to the CarbonTrace audit log. See /docs/bi-export for setup instructions.

CarbonTrace — Product-level carbon footprint SaaS for IT assets

Features · Pricing · Use Cases · Contact