Karboncheck

Materials

Status: supported

Primary focus for v1. Steel, aluminium, plastics, inox, beton.

Transport

Status: partial

Useful for many cases, but not the primary product focus.

Food

Status: experimental

Still available, but not the quality priority for the beta launch.

Estimate a material

Estimate 1 tonne of aluminium or 100 kg of plastic in one API call.

Compare two options

Compare steel vs aluminium for the same quantity and keep the lower-carbon option.

Feed an AI agent

Ask an agent which material is lower carbon and let it call search, estimate, or compare-materials.

Health check for uptime and basic connectivity.

curl "https://www.karboncheck.com/ping"

{"status": "ok"}

Create an account and return a new API key.

{
  "email": "dev@example.com"
}

curl -X POST "https://www.karboncheck.com/api/register" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "dev@example.com"
  }'

{
  "api_key": "<generated_api_key>"
}

Return current usage, quota, and remaining calls.

curl "https://www.karboncheck.com/api/my-usage" \
  -H "Authorization: Bearer <api_key>"

{
  "calls_used": 12,
  "quota": 100,
  "calls_remaining": 88,
  "created_at": "2026-03-16T10:00:00Z"
}

Search emission factors and return grouped results plus an agent-ready block.

Query string: ?query=aluminium

curl "https://www.karboncheck.com/api/recherche?query=aluminium" \
  -H "Authorization: Bearer <api_key>"

{
  "ambigue": true,
  "regroupements": [...],
  "agent": {
    "best_match": {...},
    "warnings": [...],
    "alternatives": [...]
  }
}

Estimate total emissions from a structured quantity and activity payload.

{
  "query": "aluminium",
  "quantity": 1,
  "unit": "tonne",
  "source": "auto"
}

curl -X POST "https://www.karboncheck.com/api/estimate" \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "aluminium",
    "quantity": 1,
    "unit": "tonne",
    "source": "auto"
  }'

{
  "query": "1 tonne aluminium",
  "matched_query": "aluminium",
  "factor_name": "Aluminium – neuf",
  "factor_value": 7803.0,
  "factor_unit": "kgCO2e/tonne",
  "result_kgco2e": 7803.0,
  "result_unit": "kgCO2e",
  "warnings": [...],
  "alternatives": [...]
}

Compare multiple material options and return a low-carbon ranking.

{
  "options": ["steel", "aluminium"],
  "quantity": 1,
  "unit": "tonne",
  "source": "auto"
}

curl -X POST "https://www.karboncheck.com/api/compare-materials" \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "options": ["steel", "aluminium"],
    "quantity": 1,
    "unit": "tonne",
    "source": "auto"
  }'

{
  "quantity": 1,
  "unit": "tonne",
  "ranking": ["steel", "aluminium"],
  "best_low_carbon_option": "steel",
  "options": [...],
  "warnings": [...]
}

Lightweight manifest describing the current MCP preparation status.

curl "https://www.karboncheck.com/mcp.json"

{
  "name": "Karboncheck",
  "status": "experimental",
  "transport": {"implemented": false},
  "tools": [...]
}

Machine-readable OpenAPI schema generated by FastAPI.

curl "https://www.karboncheck.com/openapi.json"

{"openapi": "3.1.0", "...": "..."}

JavaScript fetch

const apiKey = process.env.KARBONCHECK_API_KEY;

const response = await fetch("https://www.karboncheck.com/api/estimate", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": `Bearer ${apiKey}`,
  },
  body: JSON.stringify({
    query: "aluminium",
    quantity: 1,
    unit: "tonne",
    source: "auto",
  }),
});

const data = await response.json();
console.log(data);

Python requests

import os
import requests

api_key = os.environ["KARBONCHECK_API_KEY"]
response = requests.post(
    "https://www.karboncheck.com/api/estimate",
    headers={"Authorization": f"Bearer {api_key}"},
    json={
        "query": "steel",
        "quantity": 1,
        "unit": "tonne",
        "source": "auto",
    },
    timeout=10,
)
response.raise_for_status()
print(response.json())

JavaScript compare materials

const apiKey = process.env.KARBONCHECK_API_KEY;

const compare = await fetch(
  "https://www.karboncheck.com/api/compare-materials",
  {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${apiKey}`,
  },
  body: JSON.stringify({
    options: ["steel", "aluminium"],
    quantity: 1,
    unit: "tonne"
  }),
});
console.log(await compare.json());

Python compare materials

import os
import requests

api_key = os.environ["KARBONCHECK_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}"}

compare = requests.post(
    "https://www.karboncheck.com/api/compare-materials",
    headers=headers,
    json={
        "options": ["steel", "aluminium"],
        "quantity": 1,
        "unit": "tonne",
    },
    timeout=10,
)
compare.raise_for_status()
print(compare.json())

Missing or invalid API key on /api/recherche, /api/estimate, /api/compare-materials, or /api/my-usage.

{
  "detail": "API key is missing."
}

No compatible factor found on /api/estimate or no option could be resolved in a comparison.

{
  "detail": "No compatible emission factor was found."
}

Invalid payload, empty query, or non-positive quantity.

{
  "detail": "The 'quantity' field must be strictly positive."
}

Quota reached or rate limit exceeded.

{
  "detail": "You reached your quota. Request higher usage."
}