Support: support@tinplate.dev · Zero-Retention Edge Security Support Trust Center DPA GitHub Issues
AI Data Prep Live on Hub

Broken JSON Healer API — Deterministically Repair Malformed LLM JSON Outputs

Repair malformed or truncated LLM JSON outputs into valid, schema-checked JSON in 1 ms. Fix broken JSON from LLMs in under 2 ms: strip Markdown code fences, close truncated brackets, fix trailing commas, unescaped quotes, and Python literals.

Interactive Sandbox · No API Key Required 200 OK · Ready
POST /v1/json-healinput
200 OK sample / live responsejson
{
  "ok": true,
  "data": {
    "valid": true,
    "data": {
      "name": "Ada",
      "active": true,
      "tags": [
        "ai",
        "edge"
      ]
    },
    "healed_json": "{\"name\":\"Ada\",\"active\":true,\"tags\":[\"ai\",\"edge\"]}",
    "repairs": [
      "stripped_markdown_fence",
      "normalized_single_quotes",
      "normalized_literals",
      "removed_trailing_commas",
      "closed_truncated_containers"
    ],
    "schema_valid": null,
    "schema_errors": []
  },
  "meta": {
    "request_id": "req_jh_01",
    "ms": 1
  }
}
OpenAPI 3.0.3 Get All-Access Key ($29/mo) No signup. No payload storage.
Quickstart Code Examples
curl -X POST "https://api.tinplate.dev/v1/json-heal" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TINPLATE_KEY" \
  -d '{"raw":"Sure! Here is the JSON:\n```json\n{\"name\": \"Ada\", '\''active'\'': True, \"tags\": [\"ai\", \"edge\",]\n"}'
import { TinplateClient } from "@tinplate/sdk";

const tinplate = new TinplateClient({
  apiKey: process.env.TINPLATE_API_KEY!,
});

const { data, meta } = await tinplate.call("/v1/json-heal", {
  "raw": "Sure! Here is the JSON:\n```json\n{\"name\": \"Ada\", 'active': True, \"tags\": [\"ai\", \"edge\",]\n"
});
console.log(`[${meta.ms} ms]`, data);
import requests

response = requests.post(
    "https://api.tinplate.dev/v1/json-heal",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer YOUR_TINPLATE_KEY",
    },
    json={
  "raw": "Sure! Here is the JSON:\n```json\n{\"name\": \"Ada\", 'active': True, \"tags\": [\"ai\", \"edge\",]\n"
}
)
print(response.json())
const response = await fetch("https://api.tinplate.dev/v1/json-heal", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_TINPLATE_KEY",
  },
  body: JSON.stringify({
  "raw": "Sure! Here is the JSON:\n```json\n{\"name\": \"Ada\", 'active': True, \"tags\": [\"ai\", \"edge\",]\n"
}),
});
const result = await response.json();
console.log(result);
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tinplate_json_heal",
    "arguments": {
      "raw": "Sure! Here is the JSON:\n```json\n{\"name\": \"Ada\", 'active': True, \"tags\": [\"ai\", \"edge\",]\n"
    }
  }
}
OpenAPI 3.0.3 Schema Contract

Request Parameters & Response Schema Reference

Request Body Parameters (POST /v1/json-heal)

ParameterType & ConstraintsDescription
raw required string
minLen: 1, maxLen: 262144
Malformed JSON or LLM output string (max 256 KB).
schema optional object Optional JSON Schema (draft subset) to validate the healed JSON against without eval.

Response data Object Fields (200 OK)

FieldTypeDescription
valid boolean Field 'valid'
data any | null Field 'data'
healed_json string | null Field 'healed_json'
repairs string[] Field 'repairs'
schema_valid boolean | null Field 'schema_valid'
schema_errors string[] Field 'schema_errors'

What Broken JSON & LLM Output Healer API Detects & Validates

  • Strips conversational LLM preambles, postambles, and ```json Markdown fences
  • Repairs trailing commas, single-quoted keys/strings, unquoted keys, and JS/Python comments
  • Converts Python/JS literals (True, False, None, undefined, NaN, Infinity) to valid RFC 8259 JSON
  • Closes truncated strings, arrays, and objects caused by max_tokens cutoffs
  • Optional JSON Schema validation on the repaired output
Honest Engineering Boundaries

Known Limitations & Test Verification

Release: v1.0.39 · Verified: 16 November 2026 · Portfolio Median: 0.318 ms in-Worker V8 compute (add 15–65 ms HTTPS RTT) · See Full Portfolio Benchmarks →

  • Deterministic state-machine repair; if an input contains no JSON structure at all (e.g. plain prose), it returns a structured parse failure rather than inventing data.
  • Tested v1.0.4 (14 November 2026) across 45+ malformed LLM output fixtures.

Direct All-Access & Marketplace Plans

Direct Polar All-Access Keys unlock all 42 APIs (49 endpoints), /v1/pipeline, and /mcp on api.tinplate.dev: Pro ($29/mo · 120 req/min · 100k/mo · 128 KB) or Team ($79/mo · 300 req/min · 500k/mo · 256 KB).

PlanMonthly PriceIncluded RequestsRate LimitMax PayloadBest For
BASIC$0.00 / mo500 / month10 req / min64 KBEvaluation & CI smoke tests
PRO$9.99 / mo15,000 / month60 req / min128 KBSolo devs & production apps
ULTRA$29.99 / mo100,000 / month300 req / min256 KBGrowing SaaS & multi-agent pipelines
MEGA$79.99 / mo500,000 / month1,000 req / min256 KBHigh-volume enterprise workloads

Frequently Asked Questions

Why not just ask the LLM to retry when JSON.parse fails?

Retrying an LLM call costs 500–3,000 ms and extra token fees. JSON Healer repairs 95%+ of syntax glitches deterministically in ~1 ms.

Does it handle truncated JSON when max_tokens cuts off the response?

Yes. It tracks the open bracket/brace stack and closes unfinished strings, arrays, and objects cleanly.

Does it record which repairs were made?

Yes, the repairs array lists every transformation applied so you can audit or log repair frequency.

Zero Payload Logging

Data Handling, Privacy & Proxy Disclosure

100% in-memory deterministic state machine. Zero payload logging.

Worker Zero-Logging Guarantee: Cloudflare Workers Observability and invocation logging are disabled (observability.enabled = false, head_sampling_rate = 0, invocation_logs = false). Requests via RapidAPI or Zyla traverse marketplace proxies; use a Direct Bearer Key for zero-intermediary routing.

Related Tinplate APIs

POST /v1/tool-call-validator AI Safety & Agents

Agent Tool-Call Validator & Repairer API

Validate and auto-repair broken LLM tool-call arguments against your JSON Schema.

POST /v1/html-to-markdown Tier 1

LLM HTML-to-Markdown Cleaner API

Convert noisy web pages or raw HTML into clean, token-efficient Markdown for RAG.

POST /v1/schema-diff Developer Utilities

OpenAPI & JSON Schema Breaking-Change Diff API

Diff two OpenAPI 3.x or JSON Schemas to catch breaking changes and recommend SemVer bumps.