implemented list-all, documented how it's output is different than other types of the API