db api design

Addressed.