added a new api interaction method