added new fucntion to the api to be implemented