Github url


by apiaryio

apiaryio /api-blueprint

API Blueprint

8.0K Stars 2.1K Forks Last release: about 5 years ago (format-1A9) MIT License 425 Commits 11 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:


API Blueprint

API Design for Humans


A powerful high-level API design language for web APIs.

API Blueprint is simple and accessible to everybody involved in the API design lifecycle. Its syntax is concise yet expressive.

With API Blueprint you can quickly prototype and model APIs to be created or describe already deployed mission-critical APIs. From a car to the largest Content Distribution Network (CDN) in the world.

The API Blueprint is built to encourage dialogue and collaboration between project stakeholders, developers and customers at any point in the API lifecycle. At the same time, the API Blueprint tools provide the support to achieve the goals be it API development, governance or delivery.

API Blueprint Lifecycle

Open Source

API Blueprint is completely open sourced under the MIT license. Any contribution is highly appreciated.

At home on GitHub

API Blueprint language is recognized by GitHub. You cansearch for API Blueprint or use the


language identifier forsyntax highlighting.

Getting started

All it takes to describe an endpoint of your API is to write:

# GET /message + Response 200 (text/plain) Hello World!

in your favorite plain text editor.

With this blueprint you can already get a mock, documentation andtest for your API before you even start coding.

To learn more about the API Blueprint syntax jump directly to theAPI Blueprint Tutorial or take a look at some examples.

Media Type

The media type for API Blueprint is



Learn more


The plans for API Blueprint are completely tracked on GitHub – see theAPI Blueprint Roadmap.


Building tools for API Blueprint is possible thanks to its machine-friendly face provided by API Blueprint parser.

If you are interested in building tools for API Blueprint check out theDeveloping tools for API Blueprint.


Feel free report problems or propose new ideas using the API Blueprint GitHubissues.

We use an RFC process for proposing any substantial changes to the API Blueprint language, specification and/or parsers.

If you would like to propose a change, please consult ourRFC process.

Get in Touch


MIT License. See the LICENSEfile.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.