improved verification API - closes #6