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
$0
- +Design sustainability benchmarks
- +Efficiency scoring (read-only)
- +Public material provenance lookup
- +100 requests/day
L3Marketplace Feeds
Starter
$49/mo
- +Everything in Free
- +Real-time material inventory feeds
- +Recovery rate analytics
- +Material valuations & dispositions
- +5,000 requests/day
L2Pipeline
Pro
$149/mo
- +Everything in Starter
- +Webhook event subscriptions
- +CSV/Parquet bulk export
- +Equity curve projections
- +RCM performance models
- +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_hereMaterial provenance lookup (/api/v1/materials/provenance/{mlId}) requires no authentication.
Rate Limits
100/day
Free
5K/day
Starter
25K/day
Pro
Custom
Enterprise