started descibing needed api methods