{"uid":"cap_H6wwrSLYwidA_gV2eFp9E","slug":"myco2-suite-emission-factor-lookup-7118e338","name":"MyCO2 Suite – Emission Factor Lookup","description":"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.","url":"https://api.myco2suite.io/api/v1/factor?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_vI8TMzBHRG-2XUgx195E4","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches a single emission factor record (value, unit, methodology, source, licence) by ID, activity type, BEA code, or spend classification for audit-grade provenance.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Audit trail for sustainability report","prompt":"I need to pull the full emission factor record — value, unit, source, and methodology — for factor UUID 'a3f1c2d4-7b88-4e2a-9f01-bc34de567890' so I can attach it as evidence in our GHG audit report."},{"title":"Spend-based factor for MCC code","prompt":"What is the emission factor MyCO2 Suite uses for MCC code 5812 (eating places and restaurants) in the US? I need the value, unit, and licence details for our Scope 3 category 1 disclosure."},{"title":"BEA code factor lookup for procurement","prompt":"Fetch the US BEA emission factor for BEA code '333' industrial machinery manufacturing, including the methodology and data source, so our procurement team can validate the figure we used in our supplier spend analysis."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:45:43.214Z","isFirstParty":false,"canonicalSlug":"myco2-suite-emission-factor-lookup-7118e338"}