A few minor changes

Hi Kin,

I wanted you to review these because I'm not familiar with swagger, but they should amount to just typos and minor tweaks that sort of future-proof this, because we're always adding opinions and jurisdictions.

One thing I didn't change was that you dub this API version .1, but we're calling this API v1. I couldn't tell if the .1 referred to this definition or to our version-numbering system. If the latter, then I think that should be changed too.