How about putting the version number in the hostname? https://api-v1.xxxy.com/clients/list https://api-v1.xxxy.com/clients/list I believe its a little neater

How about putting the version number in the hostname? https://api-v1.xxxy.com/clients/list https://api-v1.xxxy.com/clients/list I believe its a little neater than /v1/clients/list, albeit a little less standard.