instance related function translated into the api