Jimmyfagan/bb2 3569 update swagger docs (#1277)

* Include date query param details in swagger docs.

* Re-order swagger doc v1 and v2, other adjustments.

Author: jimmyfagan