Add documentation for listing API

Add parameter to define for the sorting criteria of the returned blobs. @xla 
By convention functions prefixed with `is` will return booleans. Maybe rename that to `validateSortParam`.