Identity | Por que ocorre erro de permissão ao tentar utilizar o método email da API REST v2?

Ocorrência

Estou tentando utilizar o método rest/v2/users/email para obter usuários cadastrados no meu contexto do Identity através do e-mail e está dando erro de falta de permissão para usar o mesmo:

{ 
	"errorCode": 401, 
	"errorMessage": "Provided access token does not have permissions to access this resource. Only PARTNERS can access this api", 
	"possibleResponsibleField": "clientId: 93db5410-c4fe-48bd-9d06-0f88bab4663b" 
} 

Causa

Este método da API REST v2 é restrito a parceiros.

Solução

Utilizar o método GET /rest/v2/companies/{companyId}/users/email/{email}.

O companyId (ID da Empresa) pode ser obtido na aba Segurança do menu de Configurações do Identity. Para saber mais, consulte o help Token REST API.