Add examples to API that support a query.

[whitingjr]

Fixes Issue

fixes issue #796

Changes proposed

[x] - Add annotation information on API operations
[X] - Add documentation about Queries

Check List (Check all the applicable boxes)

• My code follows the code style of this project.
• My change requires changes to the documentation.
• I have updated the documentation accordingly.
• All new and existing tests passed.

[johnaohara]

There are a handful of minor issues to resolve