new API functions done
todo: POD