jsontoschema

What's the difference between "JSON Schema" and a simplified schema?

One is a validation specification. The other is a compact way to describe structure. They solve different problems.

The naming confusion

"JSON Schema" usually refers to the IETF specification (json-schema.org) for describing and validating JSON documents. It has drafts, keywords like $schema and $ref, and a rich vocabulary for constraints.

A "simplified schema" (what this tool generates) is an informal, inline representation of JSON structure. No spec, no validation, no tooling chain. Just a readable description of what's in the data.

Side by side

JSON Schema (draft-07)
{
  "$schema": "http://json-schema...",
  "type": "object",
  "properties": {
    "id": { "type": "integer" },
    "title": { "type": "string" },
    "completed": { "type": "boolean" },
    "assignee": {
      "oneOf": [
        { "type": "string" },
        { "type": "null" }
      ]
    }
  },
  "required": ["id", "title",
    "completed"]
}
Simplified schema
{
  id: number,
  title: string,
  completed: boolean,
  assignee: string | null
}

The JSON Schema version is 4x longer and requires you to know whatoneOf,properties, and required mean. The simplified version reads like pseudocode.

When to use each

JSON Schema (the spec)

Runtime validation of API requests, OpenAPI / Swagger definitions, form generation, CI/CD contract testing, and cross-language code generation.

Simplified schema

API documentation and READMEs, LLM prompt context, Slack/PR conversations about data shapes, quick exploration of unfamiliar JSON, and onboarding new team members to an API.

Can I convert between them?

Not directly. They represent different levels of detail. JSON Schema includes validation constraints (min/max, patterns, enums) that don't exist in a simplified schema. And a simplified schema includes visual brevity that JSON Schema can't express.

Think of it this way: JSON Schema is source code. A simplified schema is a whiteboard sketch. Both describe the same thing at different levels of formality.

Generate a simplified schema

Paste any JSON and get a compact, readable structure description.