added comments regarding API