ML SystemsData API

api.mlsystemsri.com

Construction Intelligence
Data API

23 endpoints across design intelligence, material recovery, construction efficiency, equity analytics, and humanoid ontology. Real data from real job sites.

7 free10 starter2 pro6 enterprise

Base URL

https://api.mlsystemsri.com/api/v1

Authentication

All endpoints (except /health) require an API key passed as a Bearer token.

# Example request
curl https://api.mlsystemsri.com/api/v1/design/styles \ -H "Authorization: Bearer ds_live_your_key_here"

Get your API key at app.mlsystemsri.com/billing

Response Format

Every response follows a standard envelope:

// Success
{ "ok": true, "data": { ... }, "error": null }
// Error
{ "ok": false, "data": null, "error": "message" }
200
Success
401
Unauthorized
403
Tier too low
429
Rate limited

Pricing Tiers

Free

Free

100 / day

Starter

$49/mo

10,000 / day

Pro

$149/mo

100,000 / day

Enterprise

Custom

1,000,000 / day

Endpoints

Design Intelligence5 endpoints

GET/design/stylesFree

Distribution of architectural styles across all design sessions.

{ totalSessions, styles: [{ style, count, percentage }] }
GET/design/sustainabilityFree

Sustainability score distribution (0–100) with bucket breakdown.

{ totalSessions, averageScore, minScore, maxScore, distribution: [{ range, count }] }
GET/design/dfdFree

Design for Deconstruction rule adoption rates across 6 DfD rules.

{ totalSessions, rules: [{ id, label, adoptionCount, adoptionRate }] }
GET/design/regulatoryFree

Regulatory envelope coverage rates across 8 zoning/permitting items.

{ totalSessions, regulatoryItems: [{ id, label, coverageCount, coverageRate }] }
GET/design/briefs/samplePro

Top 5 anonymized design briefs ranked by sustainability score.

{ samples: [{ style, sustainabilityScore, dfdRulesConfirmed, brief, generatedAt }] }

Material Recovery4 endpoints

GET/materials/recovery-ratesFree

Overall and per-category material recovery rates.

{ overallRecoveryRate, totalItems, totalRecovered, byCategory: [{ category, totalItems, recoveredItems, recoveryRate }] }
GET/materials/dispositionsFree

Material disposition breakdown (resale, reuse, recycled, discarded).

{ totalItems, dispositions: [{ disposition, count, percentage }] }
GET/materials/inventoryStarter

Paginated list of recovered materials available for resale/reuse.

Params: limit (max 100, default 50), offset (default 0)

{ items: [{ category, name, quantity, unit, weightLbs, estimatedValueCents, disposition, status, recoveredAt }], pagination: { limit, offset, returned } }
GET/materials/valuationsStarter

Valuation accuracy per category — estimated vs actual resale value.

{ byCategory: [{ category, itemCount, totalEstimatedValueCents, totalActualValueCents, valuationAccuracy }] }

Construction Efficiency3 endpoints

GET/efficiency/benchmarksFree

AI efficiency score distribution (0–100) with component averages.

{ totalProjectsScored, overall: { average, min, max }, componentAverages: { timeline, materialUtilization, costVariance, laborEfficiency }, distribution: [{ range, count }] }
GET/efficiency/phasesStarter

Phase duration benchmarks — average days per construction phase type.

{ phases: [{ phaseType, totalPhases, completedPhases, avgDurationDays }] }
GET/efficiency/timelineStarter

Milestone performance: on-time rate, average delay for late milestones.

{ totalMilestones, completedOnTime, completedLate, onTimeRate, avgDelayDays }

Equity & Financial3 endpoints

GET/equity/rcm-performanceStarter

Reversed Conventional Mortgage loan performance metrics.

{ totalRcmLoans, activeLoans, paidOffLoans, avgPrincipalCents, totalOriginatedCents, avgPaydownPercentage }
GET/equity/curvesStarter

Historical equity growth curves — anonymized, multi-cycle snapshots.

{ curves: [{ projectAlias, cycleNumber, snapshots: [{ date, propertyValueCents, principalBalanceCents, materialRecoveryCents, totalEquityCents }] }] }
GET/equity/projectionsStarter

Forward-looking equity projection using 1.09x cycle multiplier over 8-month cycles.

Params: startValue (default 500000), cycles (1–20, default 5), recoveryRate (0–100, default 85)

{ parameters: { startValueDollars, cycleMultiplier, cycleDurationMonths, recoveryRate, totalCycles }, projections: [{ cycle, monthsElapsed, propertyValue, materialRecoveryValue, totalEquity, growthFromStart }] }

Humanoid Ontology6 endpoints

GET/ontology/task-codesEnterprise

81 unique task codes from ML1 ground-truth dataset — 1,480 executions across 269 work days.

Full task code definitions with execution counts, durations, crew requirements.
GET/ontology/phasesEnterprise

13-phase construction sequence DAG with prerequisites and dependencies.

Phase definitions with prerequisite chains and estimated durations.
GET/ontology/primitivesEnterprise

51 atomic robot action primitives — the foundational motion vocabulary for construction robotics.

Primitive definitions: grasp, lift, place, fasten, measure, cut, etc.
GET/ontology/robot-paramsEnterprise

Robot parameter export: task sequences, tool requirements, body mechanics.

Per-task robot configuration: joint angles, forces, tool attachments.
GET/ontology/sequenceEnterprise

Full construction sequence with 4-tier robot deployment roadmap.

13-phase sequence with robot tier assignments (Tier 1–4).
GET/ontology/ml1-metadataEnterprise

ML1 Manual Labor node metadata: 269 work days, 38 job sites, performance benchmarks.

{ workDays, taskExecutions, uniqueTaskCodes, jobSites, dateRange }

Webhooks3 endpoints

POST/webhooksStarter

Register a webhook endpoint. Max 5 per API key. Auto-disabled after 10 consecutive failures.

Params: url (HTTPS required), events (array of event types)

{ id, url, events, secret, active, createdAt }
GET/webhooksStarter

List all webhooks registered to your API key.

{ webhooks: [{ id, url, events, active, failureCount, lastTriggeredAt, createdAt }] }
DELETE/webhooksStarter

Deactivate a webhook by ID.

Params: id (webhook UUID)

{ id, active: false }

Bulk Export1 endpoints

GET/exportPro

Download a full dataset as CSV. Supports materials, scores, equity, and phases. Parquet coming soon.

Params: dataset (materials|scores|equity|phases), format (csv)

CSV file download (Content-Disposition: attachment)

Health1 endpoint

GET/healthPublic

Service health check. No authentication required.

{ status: "ok", service: "ml-systems-data-api", version: "1.0.0", timestamp: "2026-03-03T..." }