# MyCO2 Suite — EU CBAM Calculator API

> The CBAM endpoint calculates EU Carbon Border Adjustment Mechanism liability for an imported good. Send a CN code, country of origin and weight; it returns embedded emissions, the free-allocation benchmark, certificates required, and estimated EUR liability using the year's phase-in rate and the live EU ETS price — under EU default values or your verified MRV. Batch a portfolio via /v1/cbam/batch.

Endpoint: POST https://api.myco2suite.io/v1/cbam
Price: $0.008 / call (from the first call). Pay with an API key (x-api-key) or, with no signup, via x402 pay-per-call in USDC on Base — a keyless request returns HTTP 402 with machine-readable payment requirements.
Free tier: 1,000 calls/month with a key (get one at https://myco2suite.io).

## Inputs
- cn_code (required): 8-digit CN commodity code
- origin_country (required): ISO 3166-1 alpha-2 country of origin
- weight_tonnes (required): Imported weight in tonnes (> 0)
- year (optional): Compliance year (2026–2050)
- actual_emissions_tco2e_per_t (optional): Verified MRV intensity (unlocks the with-MRV scenario)

## Example request
POST https://api.myco2suite.io/v1/cbam
Header: content-type: application/json
Header: x-api-key: <your key>   # or pay per call via x402 (no key)
Body: {"cn_code":"72071100","origin_country":"CN","weight_tonnes":100}

## Example response (JSON)
{
  "cn_code": "72071100",
  "sector": "iron_steel",
  "embedded_emissions": {
    "total_tco2e": 252.7,
    "unit": "tCO2e"
  },
  "cbam_obligation": {
    "without_own_mrv": {
      "estimated_liability_eur": 545.58
    }
  }
}

Every response is methodology-stamped: it includes the exact factor value, unit, source, licence, data year, gas basis (CO2 vs CO2e) and GWP version used.

## Common use cases
- EU importer CBAM quarterly reporting
- Estimate CBAM cost exposure across a product catalogue (via /v1/cbam/batch)
- Compare EU default values vs verified MRV to cut liability

## Related capabilities
- https://myco2suite.io/carbon/freight (freight)
- https://myco2suite.io/carbon/factor (factor)
- https://myco2suite.io/carbon/transaction (transaction)

## Links
- Human page: https://myco2suite.io/carbon/cbam
- Full API docs: https://myco2suite.io/docs
- Full agent/LLM docs: https://api.myco2suite.io/llms.txt
- Code examples: https://github.com/Jaws22/myco2-examples
- MCP server: https://api.myco2suite.io/v1/mcp (registry: io.myco2suite/carbon-intelligence)
- Contact: admin@myco2suite.io