added sample entry api methods and tests