added more API documentation