[request] Documentation for JSON output

[Cazra]

Most of the JSON output is self-explanatory, but could we get some schema documentation for it?

[mr-tz]

We're reworking it and as part of that can document it. Do you have specific requirements in mind or examples handy?