clean up tests and api responses, add api docs