updated validator api documentation