added api functionality, updated api doc and added junit dummy tests