# MyCO2 Suite — Activity-Based Emissions API

> The activity endpoint converts a physical quantity — fuel burned, electricity used, materials consumed — into verified CO₂e. Choose from 1,000+ activity types, specify a country and year, and receive Scope 1 or 2 emissions with the factor's methodology, source, licence, gas basis and GWP version. Batch up to 100 items via /v1/activity/batch.

Endpoint: POST https://api.myco2suite.io/v1/activity
Price: $0.003 / 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
- activity_type (required): e.g. electricity, diesel, natural_gas
- quantity (required): Amount in the activity's native unit (> 0)
- country (optional): ISO 3166-1 alpha-2 (defaults to GLO)
- year (optional): Data year

## Example request
POST https://api.myco2suite.io/v1/activity
Header: content-type: application/json
Header: x-api-key: <your key>   # or pay per call via x402 (no key)
Body: {"activity_type":"electricity","quantity":1000,"country":"GB"}

## Example response (JSON)
{
  "co2e_kg": 207.74,
  "factor": {
    "value": 0.20774,
    "unit": "kWh",
    "label": "UK grid electricity",
    "source": "UK Government GHG Conversion Factors (DEFRA)",
    "licence": "OGL v3.0",
    "scope": "scope_2"
  }
}

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
- Scope 1 & 2 accounting from meter and fuel data
- Corporate GHG inventories (electricity, gas, fleet fuel, materials)
- Process thousands of activity lines in one call via /v1/activity/batch

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

## Links
- Human page: https://myco2suite.io/carbon/activity
- 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