more usable interface for GET endpoints