small tweaking
added specs for returning values of all API methods