I think it would be useful to mention what is returned (and how it is structured) in this kind of API views.