made privacy and listed params optional
added some initial tests for the (not yet existing) api