note parameters on api