fix: address issue with authentication and added example

worked on docs & wip: testing

update response type and implement other methods