Move user API to primary document format

closes #2593

- added new format to user API methods
- updated tests
- little bit of cleanup in utils/api