added more helper method to response
added readme