Add documentation for listing API

Add parameter to define for the sorting criteria of the returned blobs. @xla 
All `fds` in here need to be closed in order to not leak file descriptors.