{
  "name": "CBAM Embedded Emissions API",
  "version": "v1",
  "basePath": "/cbam",
  "generatedAt": "2026-09-14T14:38:09.844Z",
  "static": {
    "base": "/cbam/api/v1",
    "endpoints": [
      {
        "method": "GET",
        "path": "/cbam/api/v1/index.json",
        "description": "This catalogue."
      },
      {
        "method": "GET",
        "path": "/cbam/api/v1/meta.json",
        "description": "Regulation metadata, key dates, de-minimis, dataset versions, sources."
      },
      {
        "method": "GET",
        "path": "/cbam/api/v1/sectors.json",
        "description": "The six in-scope CBAM sectors."
      },
      {
        "method": "GET",
        "path": "/cbam/api/v1/cn-codes.json",
        "description": "CN code → CBAM good → sector mapping."
      },
      {
        "method": "GET",
        "path": "/cbam/api/v1/cn-codes/{code}.json",
        "description": "A single CN-code mapping."
      },
      {
        "method": "GET",
        "path": "/cbam/api/v1/default-values.json",
        "description": "Default embedded-emission values per good (tCO2e/t)."
      },
      {
        "method": "GET",
        "path": "/cbam/api/v1/country-factors.json",
        "description": "Country adjustment factors."
      },
      {
        "method": "GET",
        "path": "/cbam/api/v1/markups.json",
        "description": "Default-value mark-up table (by sector and year)."
      },
      {
        "method": "GET",
        "path": "/cbam/api/v1/carbon-price.json",
        "description": "Current cached EU ETS carbon price."
      },
      {
        "method": "GET",
        "path": "/cbam/api/v1/schemas/calculate-response.schema.json",
        "description": "Calculate response JSON Schema."
      },
      {
        "method": "GET",
        "path": "/cbam/api/v1/schemas/calculation-record.schema.json",
        "description": "Calculation record JSON Schema."
      }
    ]
  },
  "compute": {
    "note": "Public/free. Anonymous access allowed; optional API key (Authorization: Bearer <key>) unlocks a higher budget and retained calculation history. Rate limited per client.",
    "endpoints": [
      {
        "method": "POST",
        "path": "/cbam/v1/calculate",
        "description": "Calculate one line → embedded emissions + certificates + cost + audit trail."
      },
      {
        "method": "POST",
        "path": "/cbam/v1/declarations/calculate",
        "description": "Calculate many lines → per-line + aggregate."
      },
      {
        "method": "GET",
        "path": "/cbam/v1/calculations/{recordId}",
        "description": "Fetch a retained calculation record (API-key holders)."
      },
      {
        "method": "GET",
        "path": "/cbam/v1/usage",
        "description": "API key usage and quota."
      }
    ]
  }
}