Skip to content
A utility to generate RAML documentation from Swagger JSON
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
src Optional support in query parameters Sep 11, 2014
.travis.yml Groovy in .travis.yml Sep 18, 2014 updating project with instructions for community contributions May 27, 2014 appveyor build config Jan 15, 2015
build.gradle swagger2raml release to Maven Central Oct 27, 2014
gradlew Gradle build files May 21, 2014

swagger2raml Build Status Windows Build Status Get automatic notifications about new "swagger2raml" versions

A utility to generate RAML documentation from Swagger JSON.


swagger2raml can be used either from command line (requires Java to be on the PATH) or as a Java library.

Command line

java -jar swagger2raml-1.0.0.jar [-o outputFileName] <swaggerApiUrl>


  • outputFileName is an optional parameter to specify the RAML file name (default is api.raml),
  • swaggerApiUrl is the URL of the Swagger API endpoint which provides resource listing as JSON.

Your application

RamlGenerator.generateFromSwaggerUrl(String url, String outputFileName)

method with the parameters as described in the command line usage.

Grab the JAR from Maven (Bintray or Maven Central repository) or use the bundled one:


repositories {

compile ''



Bundled JAR

Add swagger2raml-1.0.0-bundled.jar from Releases to your CLASSPATH

Contributing to this project

Anyone and everyone is welcome to contribute. Please take a moment to review the guidelines for contributing.


You can’t perform that action at this time.