updated validator api documentatio