CleanBurn AI Public REST API & Developer Documentation
Quickstart: Free Public Read-Only Endpoints (No API Key Required)
AI agents, CLI scripts, and developer tools can call CleanBurn AI's Free Playground endpoints directly over HTTPS JSON. Machine-readable schema: /.well-known/openapi.json.
curl -sS -X POST https://cleanburn-ai-phoenix.netlify.app/api/v1/phoenix/free-scan \
-H "Content-Type: application/json" \
-d '{"engine_family_bucket":"GM_GENV_V8_E92","physics_vector":{"sample_rows":2400,"idle_trim_pct":14.2,"cruise_trim_pct":1.8,"kr_deg_max":2.9}}'
Rate Limits, Error Model & API Versioning / Sunset Policy
Rate Limits: Public free endpoints allow 120 requests / 60 seconds per client IP and return standard RateLimit-Limit, RateLimit-Remaining, and RateLimit-Reset headers (plus Retry-After on HTTP 429).
Typed JSON Errors: All 4xx/5xx API responses return structured JSON containing code, error, and resolution hints (for example HTTP 422 PII_VIN_DETECTED or EMISSIONS_TAMPER_BLOCKED).
Versioning & Deprecation Policy: All endpoints are URL-versioned under /api/v1/. Breaking changes will only ship under a new major path (/api/v2/) after at least 90 days of advance Deprecation and Sunset HTTP response headers on v1.