refs #1 - client api complete