further additions to the battle api