Add documentation for listing API

Add parameter to define for the sorting criteria of the returned blobs. @xla 
This function naming is too generic and should be renamed to reflect better what exactly it validates, also I expected it to be in the same file as helper function and was surprised to find it in another place.