Which API's to use?

Can someone please help me in figuring out that which API’s have to be used. The swagger has only v1 API’s, but in one yaml file , there are v2 API’s available. I am not able to figure out, which API’s has to be used. Is there any place where all the updated API’s are available?

Any help will be appreciated. Thanks