Absolutely that might be common for the documentation to be faulty. I made a wish earlier and made this post with hope for Devs to pick up on it and possibly modify the API call return information. So in the end we can use it for more practical uses.
... View more