puppetdb api docs should include concrete examples

In https://docs.puppetlabs.com/puppetdb/latest/api/commands.html, I'm having an extremely difficult time figuring out how to construct a curl command that would issue any of these commands. I'm not sure whether I'm just clueless, but these docs just don't give me enough to interact with the API.

As an example, https://forgeapi.puppetlabs.com/ provides the kind of in-depth documentation I'm looking for. They use http://swagger.io/ to generate that documentation programmatically.