Carbon API

Carbon Certificate API

Store and retrieve client-supplied CO₂ records per SKU (GHG Protocol / ISO tags). You provide co2_kg — KadmilOS does not run an LCA engine. Optional link to a DPP via dpp_id. Base URL: https://www.vinket.eu/api/v1/carbon

← Back to KadmilOS API overview

Same as all KadmilOS endpoints — pass your kos_live_* key and ensure the carbon module is enabled.

header

Authorization: Bearer kos_live_YOUR_KEY

Authentication

Same as all KadmilOS endpoints — pass your kos_live_* key and ensure the carbon module is enabled.

header

Authorization: Bearer kos_live_YOUR_KEY

Create a carbon certificate

Prefer external_sku (no VinKet inventory). Alternatively pass item_id. Optionally pass dpp_id. co2_kg is required and always client-supplied.

POST /api/v1/carbon

curl -sS -X POST https://www.vinket.eu/api/v1/carbon \
  -H "Authorization: Bearer $KADMILOS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "external_sku": "SKU-2024-001",
    "co2_kg": 1.84,
    "scope": "3",
    "methodology": "ghg_protocol",
    "co2_breakdown": {
      "materials": 0.9,
      "manufacturing": 0.6,
      "transport": 0.34
    },
    "certificate_number": "KM-CARBON-2026-001"
  }'

Retrieve certificates

Query by external_sku or item_id for audit trail and CSRD data exports. Brand owns CSRD report preparation.

GET

curl -sS "https://www.vinket.eu/api/v1/carbon?external_sku=SKU-2024-001" \
  -H "Authorization: Bearer $KADMILOS_KEY"

Key fields

co2_kg — required; client-supplied footprint (no built-in LCA)
external_sku or item_id — one required
methodology — ghg_protocol / iso_14064 / iso_14067 / pef / custom
scope — 1 / 2 / 3 / full (not scope_3)