Respected Sir

The API is a bit clunky but your understanding of the API is correct. The reason the API is designed like this is for performance - this way the response is always bounded.

We won't be making any changes...