Olá, @wladpaiva. Boa tarde! Tudo bem?
Não temos um endpoint de API para consultar a chave Pix. É importante pontuar que consultar a chave Pix sem fazer uma transferência na sequência pode não ser seguro, pois a chave pode ser excluída ou transferida para outro titular a qualquer momento. A única exceção são as chaves do tipo CPF ou CNPJ, que só podem estar associadas às contas vinculadas ao respectivo documento. Ou seja, validar uma chave agora não garante que ela continue válida momentos depois.
Se sua intenção é validar a chave para fazer uma transferência Pix, recomendamos usar nosso endpoint PUT /v2/gn/pix/:idEnvio de envio de Pix.
Com este endpoint, a validação da chave ocorre no momento da transferência Pix. A melhor prática é informar o CPF/CNPJ e a chave __no momento do envio do Pix__. Nesse processo, nossa API verifica se a chave Pix pertence ao titular do documento informado. Caso contrário, a transferência é recusada.
Mas como mencionado pelo Rubens, você estará consumindo um serviço de envio de Pix via API, este possuiu uma tarifa.