Quickstart

Make your first authenticated request in under a minute using the public demo key.

1. Grab a key

Every example below uses the shared demo key. It is rate-limited and read-only, perfect for exploring. When you are ready for production, generate a live key from the Settings page of your Material Transition account.

mt_demo_1234567890abcdef1234567890abcdef

2. Make a request

cURL

curl https://api.materialtransition.com/v1/materials?q=biodegradable \
  -H "Authorization: Bearer mt_demo_1234567890abcdef1234567890abcdef"

JavaScript (fetch)

const res = await fetch(
  "https://api.materialtransition.com/v1/materials?q=biodegradable",
  { headers: { Authorization: "Bearer mt_demo_1234567890abcdef1234567890abcdef" } }
);
const { data, total } = await res.json();
console.log(`${total} materials`, data);

Python (requests)

import requests

res = requests.get(
    "https://api.materialtransition.com/v1/materials",
    params={"q": "biodegradable"},
    headers={"Authorization": "Bearer mt_demo_1234567890abcdef1234567890abcdef"},
)
print(res.json()["total"], "materials")

3. Read the response

Collection endpoints return a consistent envelope with data, total, page, and per_page:

200 OK

{
  "data": [
    {
      "id": "mycelium-composite",
      "name": "Mycelium Composite",
      "category": "Advanced Biomaterials",
      "sustainability": { "score": 95, "biodegradable": true, "carbon_kg_co2e_per_kg": 0.4 },
      "supplier_count": 9
    }
  ],
  "total": 6,
  "page": 1,
  "per_page": 20
}

Next steps

Learn how authentication works.
Understand pagination and error handling.
Explore every endpoint in the interactive reference.