various API methods - skeleton