consider to add a json-schema reference to the output?

[GVogeler]

JSON-Schema would allow validation and documentation. Documentation is already done with this API definition. Validation would make it easier to control output, but on the other hand API conformity should theoretically be sufficient.