new apis. added validation