Why it is hard to find proper documentation for docker/docker hub api?

I am struggling to find consistent and informative API documentation for docker or docker hub for operations like listing tags, images, what are the parameters I can use similar to page_size and how can I order the result… etc?

The official docs for the enine is easy to find: https://docs.docker.com/engine/api/v1.40/ (swagger openapi docs).

Afaik Docker Hub’s api docs can not be found directly. You can find the docker registry’s api docs here, which at one point was, and I hope still is the registry und the hood.

You can find swagger api docs for commercial private on-prem Docker Trusted Registry, though the api is not the same as Docker Hub’s.