added comments for all api calls