let api call raise for bad params

an integer is always ok, no lookup here.
otherwise let the api call raise for network or parameter issues.

shall we use safe_call in list() here ?