Skip to main content

JSON to Python Dataclass

Paste JSON and get Python dataclasses, Pydantic v2 models or TypedDicts with type hints. Private, runs in your browser.

Paste JSON on the left. Add a second sample to find optional fields.

JSON input

Stays in your browser

Python code

The generated code appears here.

Shortcuts: Ctrl+Enter run · Ctrl+Shift+C copy result · / search (use ⌘ on Mac)

Next steps

Free Online JSON to Python Dataclass Generator

Create typed Python classes from a JSON sample, as dataclasses, Pydantic models or TypedDicts. It gives developers a quick browser-based way to solve a focused json to python dataclass task before moving the result into a project.

How to generate Python code from JSON

Paste a JSON object or an array of objects into the input box and press Generate. Optional and nullable fields get a None default, written as X | None or Optional[X]. Pydantic output uses Field(alias=...) for keys that are not valid Python names.

One input, every language

Your JSON stays in the box when you switch the language tabs, and the code is generated again at once. Each language also has its own page, so you can bookmark the one you use.

How types are worked out

  • Whole numbers and numbers with decimals are told apart.
  • Add more samples with Add sample: a key missing from some samples becomes optional, and null makes a type nullable.
  • Arrays of objects are merged into one type, and nested objects become their own types named after the key.
  • Keys that are not valid names in the language (such as first-name or 2fa) are renamed and mapped back, never rejected.

Worked example

The sample JSON in the box above, generated with the default options:

{
  "id": 1,
  "name": "Ada",
  "email": null,
  "tags": ["x"],
  "address": { "city": "Pune", "pin": "411001" },
  "createdAt": "2026-01-15T10:30:00Z"
}
from dataclasses import dataclass


@dataclass
class Address:
    city: str
    pin: str


@dataclass
class Root:
    id: int
    name: str
    tags: list[str]
    address: Address
    created_at: str
    email: str | None = None

Common mistakes

  • A single sample cannot show which fields are optional. Paste two or three different responses for a realistic result.
  • A value that is always null gives no type information, so it is treated as a nullable string. Change it by hand if it is something else.
  • Numbers are typed from the samples: 1 and 1.0 look the same in JSON, so use a sample with decimals where you need a float.

Frequently asked questions

Which style should I use?
Pydantic checks and converts data when you load it, which suits API input. Dataclasses are plain and fast. TypedDict only describes dictionaries for type checkers.
Why are optional fields last in dataclasses?
Python requires fields with defaults to come after the fields without. The tool reorders them for you.
Which Python version is needed?
X | None needs Python 3.10 or newer. Choose Optional[X] for older versions.
Is my JSON uploaded?
No. The types are worked out in your browser. Nothing you paste is sent to a server.
How do I use this json to python dataclass tool?
Use the interactive controls above; processing stays in your browser and the result is intended as a practical starting point for development work.

More Formatters & Parsers

View all Formatters & Parsers tools →