CBAM Data
Log in Sign up
Changelog

API changes in each release

An entry names the endpoints and response fields it moved, and the dataset version behind it. An answer keeps the version that produced it, so an old filing still checks out.

  1. v1.3.0

    Free allocation adjustment from the CBAM benchmarks

    dataVersion 2026-10-19.451099948819

    Added

    • The CBAM benchmarks of Reg (EU) 2025/2620: 2,465 values by CN code and production route. benchmarks
    • An estimate now returns the benchmark it used, the cross-sectoral correction factor and the free allocation adjustment in tCO2e. freeAllocationAdjustment
    • A notice when the adjustment is an estimate: no benchmark covers the code, the data is actual, or the year is after 2030. FREE_ALLOCATION_ESTIMATED

    Changed

    • The factor is now the CBAM factor of Directive 2003/87/EC Art. 10a(1a), the share of the benchmark you deduct: 0.975 in 2026, falling to 0 in 2034. cbamFactor

    Fixed

    • Costs took 97.5% off the embedded emissions in 2026, when the regulation takes off 97.5% of the CBAM benchmark. So 2026 costs came out about 29 times too low for Indian hot-rolled coil. Estimates now deduct the free allocation adjustment of Reg (EU) 2025/2620. GET /v1/resolve
  2. v1.2.0

    Agent protocols, EUDR resolution and developer packages

    dataVersion 2026-09-15.d560045608f6

    Added

    • The A2A agent discovery and inquiry endpoint for autonomous AI systems. GET /a2a
    • EU Deforestation Regulation (EUDR) commodity check and resolution by CN code. GET /v1/eudr/resolve
    • Official Model Context Protocol server published for agent and assistant integrations. @cbamdata/mcp
    • Command-line tool for terminal workflows and fast CN code resolution. @cbamdata/cli
    • Multilingual guidance across eight languages with localized threshold rules. guides

    Changed

    • API key minting upgraded to base62 encoding. api-keys
    • API keys gated to the Developer plan tier. Developer
  3. v1.1.0

    Auditable estimates and legal provenance

    dataVersion 2026-09-15.d560045608f6

    Added

    • Every default-value estimate returns the raw row it selected, with its annex, Official Journal URL and publication date. sourceTrail
    • A heading that covers both in-scope and out-of-scope children answers with an advisory notice and the codes it covers. PARTIAL_CN
    • Weight accepts a unit, so a caller holding kilograms no longer converts before the call. weight
    • Default values published for every Annex I sector. defaults

    Changed

    • Electricity takes its quantity in tonnes, which is the established MWh field. A weight input returns an error naming that field. INVALID_INPUT
  4. v1.0.0

    The public API on cbamdata.eu

    dataVersion 2026-09-15.d560045608f6

    Added

    • One endpoint answers scope, factor, mark-up, threshold, price and filing date for a CN code. GET /v1/resolve
    • The dataset diff, version to version, as the change feed. GET /v1/changes
    • A generated OpenAPI document for client generation. /openapi.json
    • The calculator answers 3 times a day with no account.
    • The marketing shell and the calculator read in 24 languages.
    • Privacy and terms pages, and a consent banner that defaults to refusing.

    Changed

    • The 50 tonne rule returns as a flag. The engine never decides a caller is exempt. thresholdApplies
  5. v0.2.0

    The 2026 nomenclature and the certificate price

    Added

    • Annex I scope resolved to 8 digits on the 2026 CN nomenclature. scope
    • The quarterly certificate price, read from the Commission page it is published on. certificate-price

    Changed

    • Plans are billed by the month, not by the request.
    • The product is CBAM Data. cbamapi.eu redirects to cbamdata.eu.
  6. v0.1.0

    The engine

    Added

    • A pure scope and estimate engine. Every constant names the article of Reg (EU) 2023/956 it implements. engine
    • Seed datasets and the ingest scripts that write them. data/

This is the product log. The dataset's own diff is machine-readable at /v1/changes with a Developer key, and the schema is at /openapi.json.