node package manager
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »


npm version Build status Join us in Slack

quicktype generates strongly-typed models and serializers from JSON, JSON Schema, and GraphQL queries, making it a breeze to work with JSON type-safely in any programming language.

Supported Inputs

JSON JSON API URLs JSON Schema GraphQL queries

Target Languages

C# Go C++ Java TypeScript Rust
Swift Objective-C Elm JSON Schema

Missing your favorite language? Please implement it!


There are many ways to use quicktype. is the most powerful and complete UI. The web app also works offline and doesn't send your sample data over the Internet, so paste away!

For the best CLI, we recommend installing quicktype globally via npm:

npm install -g quicktype

Other options:

* limited functionality

Using quicktype

# Run quicktype without arguments for help and options 
# quicktype a simple JSON object in C# 
echo '{ "name": "David" }' | quicktype -l csharp
# quicktype a top-level array and save as Go source 
echo '[1, 2, 3]' | quicktype -o ints.go
# quicktype a sample JSON file in Swift 
quicktype person.json -o Person.swift
# A verbose way to do the same thing 
quicktype \
  --src person.json \
  --src-lang json \
  --lang swift \
  --top-level Person \
  --out Person.swift
# quicktype a directory of samples as a C++ program 
# Suppose ./blockchain is a directory with files: 
#   latest-block.json transactions.json marketcap.json 
quicktype ./blockchain -o blockchain-api.cpp
# quicktype a live JSON API as a Java program 
quicktype -o

The recommended way to use quicktype is to generate a JSON schema from sample data, review and edit the schema, commit the schema to your project repo, then generate code from the schema as part of your build process:

# First, infer a JSON schema from a sample. 
quicktype pokedex.json -o schema.json
# Review the schema, make changes, 
# and commit it to your project repo. 
# Finally, generate model code from schema in your 
# build process for whatever languages you need: 
quicktype -s schema schema.json -o src/ios/models.swift
quicktype -s schema schema.json -o src/android/
quicktype -s schema schema.json -o src/nodejs/Models.ts
# All of these models will serialize to and from the same 
# JSON, so different programs in your stack can communicate 
# seamlessly. 


quicktype is Open Source and we love contributors! In fact, we have a list of issues that are low-priority for us, but for which we'd happily accept contributions. Support for new target languages is also strongly desired. If you'd like to contribute, need help with anything at all, or would just like to talk things over, come join us on Slack.

Setup, Build, Run

quicktype is implemented in TypeScript and requires nodejs and npm to build and run.

Clone this repo and do:

npm install
script/quicktype # rebuild (slow) and run (fast) 


Install Visual Studio Code, open this workspace, and install the recommended extensions:

code . # opens in VS Code 

Live-reloading for quick feedback

When working on an output language, you'll want to view generated output as you edit. Use npm start to watch for changes and recompile and rerun quicktype for live feedback. For example, if you're developing a new renderer for fortran, you could use the following command to rebuild and reinvoke quicktype as you implement your renderer:

npm start -- "--lang fortran pokedex.json"

The command in quotes is passed to quicktype, so you can render local .json files, URLs, or add other options.


quicktype has many complex test dependencies:

  • dotnetcore SDK
  • Java, Maven
  • elm tools
  • g++ C++ compiler
  • golang stack
  • swift compiler
  • clang and Objective-C Foundation (must be tested separately on macOS)
  • rust tools

We've assembled all of these tools in a Docker container that you build and test within:

# Build and attach to Docker container 
# Run full test suite 
npm run test
# Test a specific language (see test/languages.ts) 
FIXTURE=golang npm test
# Test a single sample or directory 
FIXTURE=swift npm test -- pokedex.json
FIXTURE=swift npm test -- test/inputs/json/samples