added tests for three API methods