If I had not been thrown off by suddenly getting only 20 instead of ~200 results, I would never have noticed.

It would be great that if APIs really need to change their promises, to move the new implementation under api/next-number/ and just make the old one return a 404 or something.

A hard error code would've been easy to detect, "mysteriously" missing results with success code, not so much.