add example custom validation
move REST methods down for easier explanation