Documentation enhancement

[carmelag]

The documentation of the API can be enhanced by improving the structure and readability of the README document.
Some more information about the parameters, the values to be used to set them and the responses that the API provides can be added.

[carmelag]

I'm working on some documentation changes on the branch api-docs-changes. Could anyone of the owners/collaborators assign this issue to me, please?
Thanks in advance for your time and help!