API Documentation

The ML Systems Data API provides construction intelligence at four integration depths. From free sustainability benchmarks to enterprise ontology licensing.

Base URL: https://api.mlsystemsri.com

Integration Depth

L4Benchmarks

Free

+Design sustainability benchmarks
+Efficiency scoring (read-only)
+Public material provenance lookup
+Level 0 verification (public record)
+100 requests/day

L3Marketplace Feeds

Starter

$49/mo

+Everything in Free
+Real-time material inventory feeds
+Recovery rate analytics
+Material valuations & dispositions
+Level 1 verification (ML Systems verified)
+5,000 requests/day

L2Pipeline

Pro

$149/mo

+Everything in Starter
+Webhook event subscriptions
+CSV/Parquet bulk export
+Equity curve projections
+RCM performance models
+Level 2 verification (double-verified with state)
+25,000 requests/day

L1Ontology Licensing

Enterprise

Custom

+Everything in Pro
+81 task codes + 34 DCN codes
+Construction sequence DAG
+36 primitive actions
+ML1 metadata (269 days)
+Robot parameters export
+Dedicated support

Endpoints

Method	Path	Auth	Description
GET	/api/v1/materials/provenance/{mlId}	None	Material provenance chain
GET	/api/v1/design/sustainability	Free+	Sustainability benchmarks
GET	/api/v1/efficiency/benchmarks	Free+	Construction efficiency benchmarks
GET	/api/v1/materials/inventory	Starter+	Real-time material inventory
GET	/api/v1/materials/valuations	Starter+	Material valuations
GET	/api/v1/equity/curves	Pro+	Equity curve projections
GET	/api/v1/export	Pro+	Bulk export (CSV/Parquet)
POST	/api/v1/webhooks	Pro+	Webhook subscriptions
GET	/api/v1/materials/dem-export	Pro+	DEM environmental export
GET	/api/v1/ontology/task-codes	Enterprise	81 construction task codes
GET	/api/v1/ontology/sequence	Enterprise	Construction DAG
GET	/api/v1/ontology/phases	Enterprise	13 construction phases
GET	/api/v1/ontology/primitives	Enterprise	36 atomic actions
GET	/api/v1/ontology/ml1-metadata	Enterprise	ML1 dataset metadata
GET	/api/v1/ontology/robot-params	Enterprise	Robot execution parameters

Authentication

Include your API key in the Authorization header:

GET /api/v1/materials/inventory HTTP/1.1
Host: api.mlsystemsri.com
Authorization: Bearer ml_sk_your_api_key_here

Material provenance lookup (/api/v1/materials/provenance/{mlId}) is public for human browsers. AI crawlers without API keys receive Level 0 (public record) data only.

Verification Levels

Every material record carries a verification level. Higher levels mean more independent confirmation — and more value for AI training, compliance, and insurance purposes.

Level 0Free

Public Record

Unverified baseline — sourced from public databases (state, EPA, LEED). No provenance chain, no grading, no contamination status.

Level 1Starter+

ML Systems Verified

Provenance-tracked with ML Material ID. Graded, photographed, contamination tested. Full chain of custody from recovery to marketplace.

Level 2Pro+

Double-Verified

ML Systems data cross-confirmed with state regulator repository. Two independent sources verifying the same material record. Highest-trust construction data available.

AI Crawler Policy

ML Systems detects AI crawlers (GPTBot, ClaudeBot, Google-Extended, and others) and requires API key authentication for programmatic data access.

Without API key: AI crawlers receive Level 0 data only (material name, category, status). No provenance, no grading, no verified data.

With API key: Full access based on your tier. Starter gets Level 1 verified data. Pro gets Level 2 double-verified data.

State regulators: Free enterprise-tier access. Regulators with state_agency accounts receive full data at no cost — their cross-verification creates the Level 2 product.

Human browsers are not affected. Material provenance pages remain publicly accessible.

Transparency Trust Protocol

Every entity interacting with ML Systems receives a Transparency Score (0–100). Your score determines access depth across both ecosystems. Earn it through participation or purchase it through a tier. The Custodian oversees the protocol.

Score	Band	Access
0 – 10	Public Record	Name, category, status — no provenance chain
11 – 30	ML Verified	Provenance chain, grading, contamination data
31 – 60	Full API	Material feeds, valuations, marketplace access
61 – 80	Double-Verified	State cross-verified data, bulk export, webhooks
81 – 100	Ontology Licensed	Construction DAG, robot params, ML1 metadata

How to increase your score

+50Enterprise tier subscription

+20Verified identity (KYC)

+15Starter tier subscription

+10Account age (1 year = full bonus)

+1Each verified material contributed

+10Each completed project cycle

100State regulator status (automatic)

Every API response includes X-TT-Score, X-TT-Band, and X-TT-Protocol headers.

Rate Limits

100/day

Free

5K/day

Starter

25K/day

Pro

Custom

Enterprise