HI, Currently different REST API methods sends response in different formats. Some API methods have Response as the return type and some have Response. IMO it is better if all the API methods fallow the same format. For instance [1] discuss a simple response format.
[1] http://labs.omniti.com/labs/jsend -- Udara Liyanage Software Engineer WSO2, Inc.: http://wso2.com lean. enterprise. middleware web: http://udaraliyanage.wordpress.com phone: +94 71 443 6897