added function to api to be implemented