Capabilities / Emission-factor lookup

Emission Factor API (Lookup)

The factor endpoint returns the underlying emission factor — value, unit, methodology, source, licence, data year, gas basis and GWP version — without performing a calculation. Look up by factor id, activity type, BEA code, or spend classification (MCC / NAICS / ISIC / SIC / NACE) for audit-grade provenance.

GET /v1/factor · $0.003 / call · API key or x402 pay-per-call

Example request

GET /v1/factor
curl -s "https://api.myco2suite.io/v1/factor?mcc=5411&country=US" \
  -H "x-api-key: $MYCO2_API_KEY"

Example response

200 OK · application/json
{
  "factor": {
    "value": 0.2845,
    "unit": "spend-based_kg_co2e_per_usd",
    "methodology": "US EPA USEEIO v2.1",
    "source": "US EPA",
    "licence": "Public Domain"
  }
}

Inputs

FieldRequiredDescription
id / activity_type / bea_code / mccYesOne lookup key (also naics / isic / sic / nace)
countryNoISO 3166-1 alpha-2

Common use cases

Resources

Related capabilities

Start Building With MyCO2 Suite Today

Get a key instantly, or let your agents pay per call in USDC via x402 — no signup.

Get your free API key