Add documentation for listing API

Add parameter to define for the sorting criteria of the returned blobs. @xla 
Why is a global variable needed? This can be usually avoided by rethinking how and where it's used. If you go with a solution like this it should be commented to communicate the reasoning and the idea behind it.