The chemicals resource lets you maintain a compliance-grade catalog of chemical products and substances used across your supply chain.
What a chemical record captures
name(required) — commercial or common name.casNumber— the CAS Registry Number that uniquely identifies the chemical substance.description— free-form details (usage, hazard notes, internal remarks).zdhcLevel— the ZDHC MRSL conformance level:NOT_REGISTERED— not present in the ZDHC GatewayLEVEL_1— basic conformanceLEVEL_2— advanced conformanceLEVEL_3— progressive conformance
active— whether the chemical is currently in use.
See the full chemical schema in the API reference.
Filtering by ZDHC level
The list endpoint supports the zdhcLevel query parameter so you can quickly surface the chemicals in a given compliance tier:
Shell
curl "{{BASE_URL}}/api/v1/chemicals?zdhcLevel=LEVEL_3"
This is the foundation of any periodic compliance audit: list the chemicals in use, group them by zdhcLevel, and flag any with zdhcLevel = NOT_REGISTERED.
Typical integrations
- MRSL compliance reports — list all chemicals, group by ZDHC level, export.
- Phase-out plans — filter on
active = trueandzdhcLevel = NOT_REGISTEREDto identify substitutions to prioritize. - Supplier qualification — cross-reference chemicals against the certifications of the supplier that provides them.
Warning
The casNumber is the authoritative identifier. Two chemicals can share a commercial name but differ in CAS; always match on CAS when reconciling across systems.