That's the best interpretation I could come up with as well. I think the general idea is to leave room in distributed APIs to add metadata later. It's not real

That's the best interpretation I could come up with as well. I think the general idea is to leave room in distributed APIs to add metadata later. It's not really just about potential pagination, but leaving yourself a way to add/change functionality later without updating all the clients in lockstep with the server (always awkward and there's never a way to pull it off 100% cleanly).