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.