fix logic-bug and ALWAYS return the records on successful request
Add documentation for the v1 API