fixed API documentation for list method