added code comments for apis