Swagger 2.0

This project contains a golang implementation of Swagger 2.0 (aka OpenAPI 2.0). It provide tools to work with swagger specifications.

Swagger is a simple yet powerful representation of your RESTful API.

Announcements

You may join the discord community by clicking the invite link on the discord badge. .

2026-07-20 : v0.36.0 will land in July (soon!)
- documentation: restyle doc site like go-openapi doc sites, dedicated doc site for examples, cover a significant part of doc-related issues.
- spec generation: codescan will publish its own lightweight CLI at a faster pace, as well as a TUI tool to instantly check how you annotated code looks like as a spec. (preview: https://github.com/go-swagger/go-swagger/issues/3372#issuecomment-4733107554). We hope we'll be able to land a Web playground on a similar principle (WASI build on top of codescan). go-swagger will still receive updates.
- code generation: we'll try our best to land a few requested enhancements among the 50-60 reachable ones. (most issues in codegen now have hit an "architecture wall": work has started on a v2 to overcome these limitations).
- our Slack channel is now closed and superseded by the .
2026-07-20 : v0.35.1 landed!
- re-instated binary release for windows ARM64
- spec generation: another round of fixes. Another small lots of features for more control over your rendered specs. Check out the documentation site dedicated to spec generation.
2026-06-22 : v0.35.0 landed! (end of June)
- code generation: security fixes that prevent generated code to produce code injected from an erroneous or malicious spec. swagger validate now warns about possibly harmful $ref (e.g. from multiple origins).
- spec generation: major bug-bashing action on go-openapi/codescan (which has eventually become fixable...). v0.35.0 closes ~200+ "generate spec" issues: bug fixes and requested enhancements.
- Spec generation now produces a detailed diagnostic of how your code annotations may be misinterpreted. A complete documentation site is now published.
- Please check it out from master (or dev docker image). Your feedback is super important!
2026-05-28 : v0.34.0 ships!
- major refactoring actions: the repo has been split in smaller chunks, easier to understand:
  - code examples have moved to go-swagger/examples, with a CI to automate code regeneration
  - codescan (the part that underpins swagger generate spec) has moved as a standalone library go-openapi/codescan. This library has been heavily refactored to prepare more significant improvements. The current version gets a few quirks already fixed.
  - diff (the implement of swagger diff) has joined go-openapi/analysis
  - package generator has been refactored to expose internal utilities (template repo, funcmaps, etc) as packages.
- Generated code now requires go-openapi/runtime v0.32.x and benefits from many bug fixes and there too a rechunking of the code.
- Generated code now requires go-openapi/swag v0.26+ and directly imports all sub-modules.
- Many long-awaited improvements on the generated client.

Documentation

https://goswagger.io

Features

go-swagger brings to the go community a complete suite of fully-featured, high-performance, API components to work with a Swagger API: server, client and data model.

Generates a server from a swagger specification
Generates a client from a swagger specification
Generates a CLI (command line tool) from a swagger specification (alpha stage)
Supports most features offered by jsonschema and swagger, including polymorphism
Generates a swagger specification from annotated go code
Additional tools to work with a swagger spec
Great customization features, with vendor extensions and customizable templates

Our focus with code generation is to produce idiomatic, fast go code, which plays nice with golint, go vet etc.

More details.

Project status

This project supports OpenAPI 2.0. At this moment it does not support OpenAPI 3.x.

go-swagger is now feature complete and has stabilized its API.

Most features and building blocks are now in a stable state, with a rich set of CI tests.

The go-openapi community actively continues bringing fixes and enhancements to this code base.

There is still much room for improvement: contributors and PR's are welcome. You may also get in touch with maintainers on our .

Installing

go install github.com/go-swagger/go-swagger/cmd/swagger@latest

go-swagger is also available as binary or docker releases as well as from source: more details.

Try it

Try go-swagger in a free online workspace using Gitpod:

Security

go-swagger turns an OpenAPI 2.0 specification into source code. Treat a specification like any other untrusted input: if you obtained it from a remote or untrusted location, review its contents before generating code from it.

The generator never executes the spec, and the generated code runs only when you build and import it. We have hardened the generators against an adversarial spec that tries to inject unwanted Go into the artifacts it produces — identifiers, struct tags, doc comments and CLI string literals are sanitized or escaped — which substantially reduces the exposure. It is not, however, a substitute for reviewing what you generate. In particular:

Remote $refs. A spec may reference other documents, possibly over the network. Those references are resolved and folded into the generated code, so inspect any external reference you do not control.
The x-go-type extension. By design, this extension lets the spec choose the Go type for a field — including an arbitrary imported package. That capability cannot easily be safeguarded: a spec using x-go-type can make your generated code import and depend on a package of its choosing. Always review specs that rely on it.

When in doubt, generate into a scratch directory, read the diff, and only then wire it into your build.

Licensing

The toolkit itself is licensed under an Apache Software License 2.0: SPDX-License-Identifier: Apache-2.0.

Just like swagger, this does not cover code generated by the toolkit. That code is entirely yours to license however you see fit.

Licence scan on dependencies