Does it generate a full OpenAPI spec or just the schema part?

It generates schema definitions (in JSON Schema form) suitable for components/schemas. It does not include paths or endpoint definitions, so the intended workflow is to paste the output under components in your spec file and reference it with $ref from each API’s requestBody or response.

How is the required list decided?

Keys present in the sample JSON are emitted as required. Remove fields you want to be optional from the required array after generation. Note that optional fields missing from the sample will not appear in the schema at all.

How are arrays with inconsistent items represented?

Arrays whose element types vary are expressed with oneOf, letting you describe arrays that can take several shapes. If the result gets unexpectedly complex, tidying the input sample produces a more concise schema.

Schema helper

JSON to OpenAPI schema

Generate an OpenAPI component schema from sample JSON in one click.
Objects and arrays are mapped to JSON Schema with required fields, and mixed arrays become oneOf definitions.
Everything runs locally in your browser—no data is sent anywhere.

Enter JSON

OpenAPI schema (components.schemas.Root)

Articles for this tool

Introduction

2026-01-11

Generate an OpenAPI Schema from JSON | Swagger-Compatible

How JSON gets turned into an OpenAPI 3.1 components schema. Covers the type-inference rules, how mixed-type arrays become oneOf, automatic date-string detection, and what to double-check after generating.

Introduction

2026-05-02

JSON Formatting and Validation: How to Read API Responses Safely

Learn how to format JSON, catch syntax errors, inspect value types, and turn API responses into types, schemas, or documentation.

Introduction

2026-02-16

The JSON Ecosystem: Connecting Formatting, Types, Validation, and API Specs

Follow one API response through formatting, TypeScript types, Zod runtime validation, and OpenAPI definitions—with real code at every step—for a clear view of type-safe API development.

Recent Articles

Use Case

2026-08-04

CREATE TABLE Reference: MySQL vs PostgreSQL vs SQLite Types & Constraints

A cross-database CREATE TABLE (DDL) reference with cheat sheets for data types, auto-increment keys (AUTO_INCREMENT / IDENTITY / rowid), foreign key ON DELETE behavior, and the CHECK constraint that MySQL silently ignores.

Introduction

2026-08-03

How CREATE TABLE Generation From a Visual Table Design Works | DDL Builder

A look inside DDL Builder, which turns a visually designed table into CREATE TABLE statements and an ER diagram. Covers the MySQL/PostgreSQL/SQLite type-mapping rules and the column-inference algorithm used for JSON samples.

Use Case

2026-07-21

GitHub Actions needs Design Patterns: Speed Up CI, Avoid the Anti-Patterns

A pattern reference for GitHub Actions job dependencies (needs). Covers diamond-shaped fan-out, concurrency cancellation, fail-fast tradeoffs, matrix-plus-needs gotchas, and reusable workflows, with copy-paste YAML examples.

Use Case

2026-07-21

SQL JOIN Types: Complete Reference to INNER, LEFT, RIGHT & FULL

A reference for SQL JOIN types (INNER/LEFT/RIGHT/FULL/CROSS/SELF) with a cheat sheet and row-count walkthroughs. Covers why one-to-many joins duplicate rows, the WHERE-vs-ON NULL trap, and how to write multi-table joins.

Introduction

2026-07-16

Case Converter: camelCase, snake_case & kebab-case — 9 Styles at Once

Convert identifiers between camelCase, PascalCase, snake_case, CONSTANT_CASE, kebab-case and more — all nine styles side by side. Handles acronym runs like HTTPServer, digits, and bulk multi-line conversion.

Introduction

2026-07-16

LLM API Cost Calculator: Compare Claude, GPT & Gemini Pricing Side by Side

Paste a prompt, set the expected output tokens, and compare per-request API costs across Claude, GPT and Gemini models. Covers input/output pricing structure, auto-updated price tables, and estimate limits.

JSON to OpenAPI schema

Guide

Samples

FAQ

Use cases

Notes