Provide the schema of the API

[uphv]

Hi,

The API documentation seems ok but it would be very helpful to also have the schema of the entities (response) so that we can easily build clients.

Thanks