Documented API GET methods - see discussion on Slack

On slack we were discussing what REST API endpoints a server should expose. We defined the initial set of GET methods. For background, please refer to Slack or comment here.