updated api to provide description