Introduction

The Material Transition API is a single REST interface to the world's sustainable-materials atlas — materials, substitutes, suppliers, emissions, and regulatory status, aggregated and cleaned from 10+ fragmented industry sources.

Every endpoint speaks JSON, authenticates with a bearer API key, and returns a consistent envelope. Base URL:

https://api.materialtransition.com

Quickstart

Make your first request in under a minute.

Authentication

How API keys and bearer tokens work.

API reference

Interactive reference with a live console.

Available endpoints

GET /v1/me Who am I (current account)

GET /v1/rate-limit Rate-limit status

GET /v1/usage Usage summary

GET /v1/health Health check

GET /v1/materials List & search materials

GET /v1/materials/{id} Get a material

GET /v1/materials/{id}/substitutes Find sustainable substitutes

POST /v1/materials/compare Compare materials

GET /v1/suppliers List & search suppliers

GET /v1/suppliers/{id} Get a supplier + footprint

GET /v1/search Unified hybrid search

GET /v1/emissions Emissions by region

GET /v1/regulatory/{material} Regulatory status

A note on this preview

This is a scaffolded preview. Responses are realistic fixtures served from an in-memory mock so you can explore the shape of the API and build against it immediately. Production payloads are served from the live Supplier Intelligence database. Response bodies carry an X-MT-Api-Mock: true header while in this mode.