add tests for API interface.  Woo code coverage!