new API functions

prepared the functions for the new API