Provide documentation on API responses

[ramiromagno]

Hi OLS Team,

The REST API documentation provides example responses but it does not document the JSON objects returned therein. It would be helpful to have JSON fields' meaning and type.