[WIP]: Add responses to documentation

I started adding JSON responses to the documentation strings.

Do we want to do it this way, or do you think I should change something?

If you think this is a good way to do it, keep the pull request open and I'll add responses to the other endpoints too.