Waste Classification
Waste classification system — Category, Type, and Subtype hierarchy used in document payloads.
Every document submitted to the Carrot API must be classified using a three-level hierarchy: Category, Type, and Subtype. This structure organizes documents for grouping, traceability, and methodology validation.
Classification hierarchy
A subtype always belongs to a type, and a type always belongs to a category. This ensures that each document is positioned correctly within the platform's classification context.
Category
The broadest classification level. It indicates the general context of the document. For supply
chain integrations, the category is typically MassID, which refers to documents tracking the
history of a waste mass.
Other categories (such as Methodology) exist for internal platform flows and are not used in
standard integrations.
Type
The type identifies the primary material or process class within a category. For example, under the
MassID category, types include:
OrganicPlasticPaperGlass
Each type helps identify the nature of the mass being tracked.
Subtype
The subtype provides the most specific classification, refining the type with detailed information about the material. For example:
- For type
Plastic:PET,HDPE,Plastic Film - For type
Organic:Food Waste,Garden Waste,Industrial Sludge
Subtypes must be sent in English. The accepted subtypes depend on the methodology under which the mass will be audited — consult the methodology-specific integration guide for the full list.
Methodology-specific subtypes
Each methodology defines the accepted subtypes for validation. A mass submitted for a methodology must use one of its accepted subtypes to pass validation rules.
Validation expectations
- The category, type, and subtype combination is required for every document.
- Category/type combinations should follow your approved business taxonomy.
- Keep mappings deterministic across environments (test and production).
- Validate unsupported combinations before API submission to avoid rejection.
External code systems
Some methodologies require external waste classification codes alongside the Carrot subtype. These codes connect the Carrot classification to national or international standards.
Ibama codes (Brazil)
Ibama (Instituto Brasileiro do Meio Ambiente e dos Recursos Naturais
Renováveis) publishes the
Brazilian List of Solid Waste
(Lista Brasileira de Resíduos Sólidos, per IN nº 13/2012). Each waste material is assigned a 6-digit
code (for example, 02 01 01). Include the Ibama code and description in the
LOCAL_WASTE_CLASSIFICATION_ID and LOCAL_WASTE_CLASSIFICATION_DESCRIPTION metadata attributes.
CDM waste categories
The CDM (Clean Development Mechanism) Tool 04 v08.1 defines waste
categories used for emission factor assignment. Each Ibama code maps to a CDM category (for example,
8.3 for food waste). The methodology uses this mapping to select the correct emission factors.
Methodology-specific code lists
BOLD Carbon requires both Ibama and CDM codes, validated by the regional-waste-classification rule.
See the
BOLD Carbon Framework — Supported waste codes
for the complete list of accepted Ibama codes and their CDM mappings.
Related references: