BOLD Carbon (CH₄) Integration Guide
Integration guide for BOLD Carbon (CH₄) Application v1.0.0 — expected events, required fields, and validation requirements.
This guide explains how to submit MassID documents that satisfy BOLD Carbon (CH₄) rules. BOLD Carbon shares most rules with BOLD Recycling and adds one Carbon-exclusive rule for emissions calculation. Geographic boundary validation is handled at the framework level.
For the base API flow, see Submitting a MassID. For the complete rules catalog, see BOLD Carbon (CH₄) Rules.
Prerequisites
- Completed the Quick Start flow.
- Familiar with Core Concepts (document model, event ordering, idempotency).
- All participants (Waste Generator, Hauler, Processor, Recycler) have valid accreditation documents.
- Recycler accreditation includes the exceeding emission coefficient required for emissions calculation.
Shared rules with BOLD Recycling
BOLD Carbon rules 1–19 are identical to BOLD Recycling. The document creation, event sequence, and field requirements for these rules are the same. See the BOLD Recycling Integration Guide for the full event-by-event breakdown covering:
- Document creation (category, type, subtype, measurement unit)
- ACTOR events for all participants (with accreditation)
- Pick-up, Transport Manifest, Weighing, Drop-off, Sorting, Recycled, and Recycling Manifest events
- Geolocation, uniqueness, biological treatment timeframe, and Ibama code validations (see Supported waste codes for accepted values)
Everything in that guide applies here. This page covers only the Carbon-exclusive addition.
Event and rule mapping
CUSTOM event names
| Event Name | Purpose | Validated by |
|---|---|---|
| PICK_UP | Waste collection from generator site | — |
| TRANSPORT_MANIFEST | Transport documentation attachment | — |
| WEIGHING | Weight capture at a calibrated scale | — |
| DROP_OFF | Delivery to the recycling/processing facility | — |
| SORTING | Waste sorting with contamination deduction | — |
| RECYCLED | Confirms composting or recycling completion | — |
| RECYCLING_MANIFEST | Final recycling documentation attachment | — |
ACTOR label vocabulary
| Label | Description | Validated by |
|---|---|---|
| WASTE_GENERATOR | Source of the waste material | — |
| HAULER | Transports waste from origin to facility | — |
| RECYCLER | Operates the recycling or composting facility | — |
| PROCESSOR | Processes sorted material | — |
Carbon-exclusive rules
Rule 20 — Prevented Emissions
Calculates prevented CO₂-equivalent emissions based on the UNFCCC AMS-III.F methodology. The calculation uses:
| Input | Source |
|---|---|
| Exceeding emission coefficient | Recycler accreditation document. |
| Baselines per waste subtype | Recycler accreditation document. |
| Greenhouse Gas Type (GHG) | MassID metadata attribute. |
| Waste subtype | MassID document subtype field. |
| MassID value | MassID document value field (weight in kg). |
What your integration must ensure:
- The recycler's accreditation document includes a valid exceeding emission coefficient and baselines for each waste subtype.
- The MassID document's subtype and value are correctly set.
- The GHG metadata attribute is present and valid.
The rule outputs the calculated prevented emissions in CO₂e.
Geographic boundary
The framework-level methodology-distance-limit rule validates the distance between Pick-up and
Drop-off locations. Distances exceeding 200 km are flagged for review. This is a framework check,
not an application rule — it does not affect the rule count.
Post-validation
When all 20 rules pass:
- A GasID certificate is issued, linked to the MassID (instead of a RecycledID).
- GasID rules run (rewards distribution for supply chain participants).
- C-CARB.CH4 (Tokenized Carbon Credits (TCC)) credit tokens are generated upon credit order settlement.
Differences from BOLD Recycling
| Aspect | BOLD Recycling | BOLD Carbon (CH₄) |
|---|---|---|
| Rules count | 19 MassID rules | 20 MassID rules (19 shared + 1 exclusive) |
| Certificate type | RecycledID | GasID |
| Credit token | C-BIOW (TRC) | C-CARB.CH4 (TCC) |
| Emissions calculation | Not applicable | Prevented CO₂e via UNFCCC AMS-III.F (rule 20) |
| Geographic boundary | Pick-up → Drop-off distance flagged at framework level | Same framework-level check (200 km threshold) |
| Accreditation data | Standard accreditation fields | Must include exceeding emission coefficient for recycler |
Common issues
All BOLD Recycling common issues apply, plus:
- Missing emission coefficient — The recycler's accreditation must include the exceeding emission coefficient. Without it, rule 20 cannot calculate prevented emissions.
- Distance flag — The Pick-up and Drop-off addresses must be geographically reasonable. Distances exceeding 200 km are flagged for review. Ensure GPS coordinates are accurate on both events.
- Missing baselines — The recycler's accreditation must include baselines for each waste subtype used in the emissions calculation.
View rules catalog · View app reference · BOLD Recycling integration guide