adding doco and responses to all api calls