JSON to TypeScript
Turn any JSON into TypeScript interfaces. Nested types named, optional keys detected.
Runs in your browser. Nothing is uploaded.
Waiting for JSON
TypeScript types appear here.What this does
Paste an API response or any JSON and get TypeScript interfaces for it. Nested objects become their own named types; arrays of objects are merged into one type.
Optional fields
If a key is missing from some items in an array, it is marked optional with ?. Turn on All optional when the API can leave out anything. A value that is sometimes null gets | null.
Names
Types are named after their keys: users becomes User, address becomes Address. Two objects with the same shape share one type. Change the root name in the box above the output.
interface or type?
Both styles describe the same shape, so pick what your codebase already uses. An interface can be extended with extends and merged with another declaration of the same name; a type alias can also hold unions and mapped types. For API responses either works. When the JSON's top level is an array, the output always includes export type Root = RootItem[], since an interface cannot describe an array on its own.
Numbers, null and unknown
TypeScript has one number type, so whole numbers and decimals both become number. A key that is null in every sample becomes null, because there is nothing to tell what it holds when set; replace it with the real type once you know it. Empty arrays become unknown[], and arrays that mix kinds of values, like [1, "a"], become unknown[] too, so the compiler makes you check before use. Keys that are not valid identifiers, such as first-name, are kept as quoted property names, so nothing is renamed.
Types are not runtime checks
These types exist only while compiling. Writing const data = (await res.json()) as Root tells the compiler what to expect but checks nothing; if the API changes, the code compiles and fails later. Base the types on a few real responses, including ones with empty lists and missing fields, and validate data from sources you do not control.
More json tools
All json tools- JSON to Go StructGenerate Go structs with json tags from any JSON. Nested structs named, pointers for nullable values.
- JSON to Kotlin Data ClassGenerate Kotlin data classes from JSON, for kotlinx.serialization, Gson, or plain Kotlin.
- JSON to Java ClassGenerate Java records or POJO classes with Jackson annotations from any JSON.
- JSON to Python DataclassGenerate Python dataclasses, Pydantic models, or TypedDicts with type hints from any JSON.
- JSON to C# ClassGenerate C# classes for System.Text.Json or Newtonsoft from any JSON. Nullable types detected.
- JSON to Dart ClassGenerate null-safe Dart classes with fromJson and toJson from any JSON. Made for Flutter.
- JSON to Swift CodableGenerate Swift Codable structs with CodingKeys from any JSON.
- JSON to Rust StructGenerate Rust structs with serde derives and Option fields from any JSON.