proper return types & request body parameters