>> If you expected the record to be found, the failure of finding it is an exception. > This is not always the case. In fact, for query APIs I do not expect it

>> If you expected the record to be found, the failure of finding it is an exception. > This is not always the case. In fact, for query APIs I do not expect it at all. And, in your case, "if you expected the record to be found" doesn't apply. If I'm iterating over a list of names/id provided by the APi, and then calling the API for more information each one, then I would expect the record to be found... because the API just told me it exists. In that case, it not being found is an exceptional condition.