polishing up the contacts api