# MyCO2 Suite – Emission Factor Lookup

> MyCO2 Suite – Emission Factor Lookup is a paid API for AI agents from api.myco2suite.io, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-11).

Fetches a single emission factor record (value, unit, methodology, source, licence) by ID, activity type, BEA code, or spend classification for audit-grade provenance.

## Facts

- Endpoint: GET https://api.myco2suite.io/api/v1/factor?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/myco2-suite-emission-factor-lookup-7118e338
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_H6wwrSLYwidA_gV2eFp9E

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability myco2-suite-emission-factor-lookup-7118e338
```

Example prompt: Can you fetch the emission factor record for activity type 'electricity-supply_grid-mix_[AU]' from MyCO2 Suite, including its value, unit, methodology, and source so I can include it in my audit trail?

## When to prefer this

Choose this endpoint when you need the raw emission factor and its provenance (value, unit, methodology, source, licence) rather than a calculated CO2e result. Ideal for audit documentation, methodology validation, regulatory disclosure footnotes, or building your own calculation pipeline where you need the underlying factor with full traceability. Use the sibling activity-based or spend-based endpoints if you want a calculated CO2e output directly.

## Known failure modes

- Unknown UUID returns 404 not found
- Invalid or unsupported MCC/NAICS/ISIC code returns 400 bad request
- Missing required query parameter (no id, activity_type, bea_code, or mcc) returns 400
- Country code not recognised returns 400 validation error
- Payment failure (x402 protocol) blocks request before processing
- Factor not available for requested country/classification combination returns 404

## How this service works

Emission-factor lookup: fetch the underlying factor (value, unit, methodology, source, licence) by id, activity_type, BEA code, or spend classification. Audit-grade provenance, no calculation.

## Output

Returns a structured emission factor object containing the numeric factor value, its unit (e.g. kgCO2e/USD or kgCO2e/kWh), the methodology used, the original data source, licence terms, and full provenance metadata — with no emissions calculation performed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "id": {
       "type": "string",
       "description": "Exact factor UUID (re-fetch for audit)"
      },
      "mcc": {
       "type": "string",
       "description": "Spend classification (also naics/isic/sic/nace)"
      },
      "country": {
       "type": "string",
       "description": "ISO 3166-1 alpha-2 (optional)"
      },
      "bea_code": {
       "type": "string",
       "description": "US BEA spend factor"
      },
      "activity_type": {
       "type": "string",
       "description": "Activity-based lookup"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/myco2-suite-emission-factor-lookup-7118e338/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.myco2suite.io](https://www.zero.xyz/host/api.myco2suite.io/llms.txt)