API documentation fixes

Some of the response data was incorrect and some of the formatting was not nice. This fixes that.