Swagger is is the best tool for this purpose. It is very simple and open-source tool for generating REST APIs documentation with JSON for Scala-based applications.and there are two cases when
1.If we use Play with Scala to develop your REST API, then use play-swagger module for REST API documentation.
2.If we use Spray with Scala to develop your REST API, then use spray-swagger module for REST API documentation.
